f-r 

t 

1  ■ 


NAVAL 


POSTGRADUATE  SCHOOL 

Monterey,  California 


DTIC 


THESIS 


ALTERATION  AND  IMPLEMENTATION  OF  THE  CP/M-86 
OPERATING  SYSTEM  FOR  A  MULTI-USER  ENVIRONMENT 


by 


Thomas  V.  Almquist 
and 

David  S.  Stevens 
December  1982 


Thesis  Advisor: 


U.  R.  Kodres 


ELECTEp 
APR  151983 


Approved  for  public  release;  distribution  unlimited 


UNCLASSIFIED _ 

MCUWITV  CC*H»lCitTIOI>  0»  TMU  Ol«  — lf< 

RePOIIT  OOCUMCNTATION  PAGE 

"TSTSovt  *ecBM55*5< 

_ 

4.  TiTkl  raM 

Alteration  and  Implementation  of  the 
CP/M-86  Operating  System  for  a  Multi> 

User  Environment 

7.  AuTmOHi'W 

Thomas  V.  Almquist 
David  S.  Stevens 

•  .  ^CK^OMMMa  OMOANIlATION  N4MC  AMO  AOOMIM 

Naval  Postgraduate  School 
Monterey,  California  93940 

II  COMTHQLUIMe  omei  NAMS  AND  AODNtSt 

Naval  Postgraduate  School 
Monterey,  California  93940 


■BAD  mSTWUCTtONS 
■BFOBB  COMDLBTOtg  rOKM 
RseiAitN?7cA7AL.oo  MWMDcn 


»•  TVNt  07  NtNONT  4  NCMOO  COVCNtO 

Master's  Thesis; 
December  1982 


(ACT  OR  ONANT  MWMDKIVO 


RROORAM  CLCMCNT.  RROJCCT  TAM 
ARIA  4  «ORK  UNIT  MUMRIRS 


12.  RIRORT  OATI 

December  1982 

II.  MUMRIR  07  RAOCS 


XtfoKinrTStSIlSTinSirTTSSmiufnTSSSullmSrcZuiSnZirSMTuT^t^ticumTVcZMnrrmrmitlSir!) 


Naval  Postgraduate  School 
Monterey,  California  93940 


Unclassified 

0ltLAIII7ICATION/0O«NaRA0lMO 

tCMiOULI 


14.  OtSTRIBuTlON  STATIMIHT  (•!  M<4  1 


Approved  for  public  release;  distribution  unlimited. 


17.  OISTRIDuTION  IT  ATInINT  Ct  I4«  aRAiract  •nfwvN  I"  SImR  20,  II  tUtmmt  *4R«i«) 


i».  Klv  VOROI  fCmutmia  tm  II  471  immillr  tr  4I«44  mmtmi 

CP/M-86,  multi-user  CP/M-86  system,  table-driven  CP/M-86  BIOS, 
AEGIS  "signal  processor"  emulation,  magnetic  bubble  memory, 

REMEX  Data  Warehouse. 

20.  ADOTRACT  fCMiNiMM  aM  alN*  II  m—Mtn  antf  4r  41444  4iM4a4) 

CP/M-86  is  a  single  user  microcomputer  operating  system 
developed  by  Digital  Research.  This  thesis  provides  a  multi¬ 
user  "protected"  CP/M-86  based  disk  sharing  environment  consisting 
of  four  Intel  iSBC  86/12A  single  board  computers,  a  MBB-80  bubble 
memory,  and  the  REMEX  Data  Warehouse  3200  memory  storage  unit. 

The  REMEX  houses  a  14  inch  Winchester  hard  disk  and  two  flexible 


DO  ,  1473  IDiriDN  07  I  NOV  00  It  ODlOkKTI 


i/n  '.I'vou'ieo! 


_ UNCLASSIFIED _  _ 

g  Cl'7  ct  AW'' -  '  ’  "IN  0  7  T-  .*  ►  ‘Jir  Dmf* 


(continuation  of  abstract) 


floppy  disk  drives  providing  In  excess  of  20  oegabytes  of  data 
storage  capacity.  The  major  objective  In  the  design  of  this 
system  was  to  create  a  table-driven  CP/M-86  Basic  Input/Output 
System  that  could  be  quickly  and  easily  reconfigured  to  adapt 
to  any  new  hardware  configuration.  Once  the  system  was  operational 
the  REMEX  hard  disk  could  then  serve  as  a  "single  processor" 
emulation  for  the  AEGIS  system.  By  making  direct  calls  to  the 
appropriate  read/write  routines,  stored  "radar  data"  could  be 
retrieved  from  the  hard  disk  for  use  by  the  other  system  processes. 


Approved  for  public  release;  distribution  unlimited 


Alteration  and  Implementation  of  the  CP/M-^ee 
Operating  S/stem  for  a  Multi-user  Environment 


by 

Thomas  7.  Almquist 

Lieutenant  Commander,  United  States  Navy 
B.S.A.E.,  North  Carolina  State  University,  1971 

David  S.  Stevens 
Captain,  United  States  Army 
United  States  Military  Academy,  1974 


Submitted  In  partial  fulfillment  of  the 
requirements  for  the  degree  of 

MASTEB  0?  SCIENCE  IN  COMPUTER  SCIENCE 


ABSTRACT 


CP/K-66  is  a  single  user  microcomputer  operating  system 
developed  by  Digital  Research.^-  This  thesis  provides  a 
multi-user  protected  CP/M-86  based  dish  sharing 
environment  consisting  of  four  Intel  iSBC  86/12A  single 
board  computers*  a  MBB-80  bubble  memory*  and  the  REKEX  Data 
Warehouse  3230  memory  storage  unit.  The  REMEX  houses  a  14 
inch  Winchester  hard  dish  and  two  flexible  floppy  dish 
drives  providing  in  excess  of  20  megabytes  of  data  storage 
capacity.  The  major  objective  in  the  design  of  this  system 
was  to  create  a  table-driven  CP/M-SS  Basic  Input/Output 
System  that  could  be  quichly  and  easily  reconfigured  to 
adapt  to  any  new  hardware  configuration.  Once  the  system 
was  operational*  the  REMEX  hard  dish  could  then  serve  as  a 
"signal  processor"  emulation  for  the  AECIS  system.  By 
mahing  direct  calls  to  the  appropriate  read/write  routines, 
stored  "radar  data"  could  be  retrieved  from  the  hard  dish 


for  use  by  the  other  system  processes. 
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A.  BACKGROUND 

One  of  the  most  popular  operating  systems  arallahle  for 
microcomputers  today  Is  the  family  of  Digital  Research's 
CP/M  operating  systems.  They  are  single  user  systen:s  which 
can  he  configured  to  interface  with  nearly  any  existing 
piece  of  hardware  simply  by  redesigning  the  Basic 
Input/Output  System  (BIOS)  module  of  CP/M.  Since  CP/M  is  a 
single  user  system,  protection  from  other  users  is  not 
normally  an  issue  of  concern  with  this  operating  system. 

MP/M,  also  marketed  hy  Digital  Research,  is  a  multi-user 
operating  system  which  supports  multiprogramming  on  a 
uniprocessor.  It  is  basically  an  expanded  version  of  C?/M. 
However,  MP/M  provides  virtually  no  protection  for  user 
files  and  very  little  protection  for  memory  in  the  event 
that  another  user's  process  crashes.  Furthermore,  when  more 
than  one  user  is  operating  under  MP/M,  system  response  time 
is  noticeably  Increased. 

B.  PURPOSE 

This  thesis  presents  an  implementation  of  CP/M-86  which 
will  permit  multiple  users,  each  with  his  own 
microcomputer,  to  access  the  same  peripheral  devices  in  a 
manner  similar  to  that  of  the  MP/M  operating  system,  but 


with  increased  user  protection.  Tbe  peripherals  used  in 
this  implementation  are  a  32K  common  memory  board,  a  MBB-60 
magnetic  bubble  memory  configured  as  a  floppy  disk  drive, 
and  a  Bemex  Data  Warehouse  memory  storage  unit  consisting 
of  a  Winchester  hard  disk  and  two  flexible  floppy  disk 
drives.  In  addition,  computer  performance  is  not 
compromised  since  each  user  has  a  dedicated  INTEL  86/12A 
iSBC  on  which  to  operate. 

The  standard  version  of  CP/M-86  requires  that  only  the 
BIOS  be  altered  to  add  additional  hardware.  While  this  is 


an  excellent  method  to  interface  hardware  with  CP/M,  it 
requires  that  the  BIOS  be  rewritten  every  time  the  hardware 
configuration  is  changed.  This  process  can  become  time 
consuming  and  is  definitely  prone  to  errors,  thus 
discouraging  frequent  system  reconfiguration.  Therefore,  in 
the  design  of  this  system,  a  major  goal  was  to  develop  a 
BIOS  which  could  easily  be  modified  if  it  was  necessary  to 
convert  from  one  hardware  configuration  to  another. 

This  thesis  was  based  on  work  accomplished  in  two 
previous  theses.  Michael  Candelor's  thesis  entitled 
"Alteration  of  the  CP/M  Operating  System"  [Ref.  1] 
initially  modified  CP/M-86  to  interface  with  the  Intel  1201 
and  1202  floppy  Disk  Controllers.  Michael  Hiciclin  and 
Jeffery  Neufeld,  in  their  thesis  "Adaptation  of  the  Magnetic 
Bubble  Memory  in  a  Standard  Microcomputer  Environment", 
[Ref.  2]  interfaced  the  MB3-80  Bubbl-Board  and  the  1232 


Floppy  Disk  Controller  with  the  CP/M-86  Operating?  System. 
Although  Hlcklln  and  Neufeld  claimed  that  their  BIOS  was 
table~drlven,  it  was  Nick  Hammond  who  really  identified  that 
the  BIOS  functions  could  he  truly  tahle-'driven  [Ref.  3]. 
This  thesis  builds  on  the  ideas  contained  in  each  of  these 
previous  works  and  expands  upon  them  to  create  a  more 
practical  and  versatile  operating  system  which  provides 
increased  protection  of  the  user's  address  space  and  files. 

Once  the  system  was  operational,  the  REMEI  hard  disk 
could  then  be  used  to  emulate  the  "signal  processor" 
functions  of  the  AEGIS  system.  Direct  calls  can  be  made  to 
the  appropriate  read/write  driver  routines  to  retrieve 
stored  "radar  data"  from  the  hard  disk  for  use  by  the  other 
emulated  processes  in  the  system. 

This  thesis  has  been  organized  into  four  major  sections. 
The  first  section  deals  with  an  overview  of  CP/M-66  and  the 
necessary  steps  required  to  create  a  new  CP/M~86  system.  It 
also  describes  how  the  BIOS  Interfaces  with  the  other 
modules  of  CP/M-86  and  the  peripheral  devices.  Included  in 
this  section  is  a  description  of  how  the  BIOS  can  be 
reconfigured  into  a  table-driven  operating  system  wnlch  will 
permit  easy  alterations  to  the  BIOS  if  the  hardware 
configuration  should  be  modified. 

The  second  section  describes  the  hardware  configuration 
utilized  in  this  thesis.  The  memory  organization  of  the 
MB3-80  Bubbl-Board  is  discussed  and  the  design  decisions 
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that  were  made  to  make  the  bubble  memory  compatible  with 


the  CP/M  operating  sytem  are  treated  in  some  detail.  The 
basic  functions  of  the  RSMEZ  Data  Warehouse  are  also 
described,  as  well  as,  the  command  packet  structure  and 
execution. 

The  third  section  is  concerned  with  the  development  of  a 
CP/M-86  operating  system  which  will  permit  four  single  board 
computers  to  operate  simultaneously  while  sharing  the  same 
peripherals.  In  this  design,  it  is  necessary  to  provide 
protection  to  common  memory  during  read  and  write  operations 
and  to  insure  that  each  user's  files  are  write  protected 
with  respect  to  all  other  uses. 

The  final  section  describes  the  tests  that  were 
conducted  to  evaluate  system  performance.  In  addition,  the 
feasibility  of  using  the  REMEX  hard  disk  to  emulate  the 
"signal  processor"  of  the  AEGIS  system  was  explored. 
Measurements  were  made  using  direct  calls  to  low-level  read 
routines  to  determine  the  optimum  skew  factor  for 
consecutive  sector  access  operations.  Also,  some 
recommendations  were  made  for  future  projects  involving  the 
REMIX  Data  Warehouse  and  the  multi-user  CP/M-e6  operating 
sys  tern. 
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II.  C£Zt3=8§ 


A.  THE  CP/M  OPERATING  SYSTEM 

CP/M-86  is  an  operating  system  developed  for  use  on  a 
single  INTEL  Corporation  86/12A  microcomputer.  CP/M  is 
supplied  with  a  number  of  built-in  utility  commands  as  veil 
as  transient  utilities  such  as  the  assembler  (ASM86.CMD)  and 
the  Dynamic  Machine  Language  Program  Debugger  (DDT86.CMD). 
These  are  described  in  detail  in  Digital  Research 
publications.  [Refs.  4-6] 

The  CP/M  operating  system  itself  is  modularized  to 
permit  easy  adaption  of  CP/M  to  any  hardvare  configuration. 
The  three  modules  are  the  Console  Command  Processor  (CCP), 
the  Basic  Disk  Operating  System  (BIOS)  and  the  user 
configurable  Basic  Input/Output  System  (BIOS).  The  first 
two  modules  are  supplied  by  Digital  Research  as  a  single  hex 
file  entitled  CPM.H66.  This  file  contains  all  the  code 
necessary  for  processing  commands  entered  at  the 
console  and  for  handling  all  logical  file  and  disk 
management  functions.  The  source  code  for  a  skeleton  BIOS 
is  also  provided  which  the  user  can  alter  to  suit  his 
individual  hardvare  requirements.  Once  the  BIOS  has  been 
modified,  it  is  assembled  and  then  concatenated  with 
CPM.H86.  The  resulting  hex  file,  CPMSTS.H66,  is  converted 
to  an  executable  file  by  the  use  of  the  CP/M  utility  program 


1.  nSlR  BI0S.A86  — >  ASMSe.CMD  ««>  USSR  BIOS .H86 

2.  CPM.E86  *  USER  BIOS .186  — >  PlP.CnO  ««>  CPMSTS.ESe 

3.  CPMSrS.BSe  «■>  gincmd.cmd  «»>  cpmsts.cmd 

(8088  COBEUAO]) 

4.  CPMSrS.CME  — >  PIP.CMD  — >  CPM.STS 

(rename  on  new  disk) 

Figure  2.1 

Steps  for  Creating  CPH.STS 

CrENCMD.CMD.  Finally,  this  file  is  renamed  CPii.STS  and  placed 
on  a  diskette  for  use.  This  process  is  shown  in  Figure  2.1. 
Details  concerning  the  operation  of  CFNCMD.CMD.  LDC0PT.CMD 
and  PIP.CMD  can  be  found  in  the  '’CP/M-06  Operating  System 
Guide".  [Hef.  6] 

CP/M-66  supports  programs  written  in  three  memory 
models:  the  8080  Model,  the  Small  Model,  and  the  Compact 

Model.  A.11  three  memory  models  are  described  in  detail  In 
Reference  5.  The  model  used  in  this  thesis  Is  the  6060 
Model  because  it  supports  programs  which  have  code  and  data 
areas  intermixed  and  which  normally  have  single  segments  of 
64K  bytes  or  less. 

3.  LOADING  CP/M-86 

The  file  CPM.STS  is  too  large  to  fit  onto  the  first  two 
tracks  of  a  normally-formatted  diskette.  Thus,  a  boot 
loader  must  be  placed  on  these  tracks  and  loaded  into  memory 
by  the  cold  start  loader.  This  boot  loader  program  will 
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then  bring  the  main  CP/M  operating  system  into  memory  and 
pass  control  to  it. 

The  leader  program  is  distributed  by  Digital  Research 
in  three  separate  modules  and  is  basically  a  subset  of  the 
entire  CP/M  system.  The  modules  are  the  Loader  Console 
Command  Processor  (LDCCP.ESe),  the  Loader  Disk  Operating 
System  (LDBD0S.H86) ,  and  a  user  configurable  Loader  Basic 
Input/Output  System  (LDBI0S.A66^  which  Is  almost  identical 
to  the  system  BIOS.  The  primary  differences  deal  with  the 
physical  memory  location  of  the  loader,  the  interrupt 
structure  and  the  BIOS  offset  address  within  the  CP/M 
system.  Assembly  of  the  loader  BIOS  is  controlled  by  a 
conditional  assembly  switch  provided  in  the  skeleton  BIOS, 
which  is  listed  in  Appendix  E  of  Reference  6.  The  steps 
needed  to  obtain  a  loader  BIOS  are  essentially  the  same  as 
for  creating  the  CPM.STS.  The  exact  steps  are  shown  in 
Figure  2.2. 


1.  USER  LDBI0S.A86  ==>  ASM86.CMD  ==>  USER  LDBIOS  .H66 

2.  LDCCP.H66  +  LDBD0S.H66  +  USER  LDBIOS. HB6  ==>  PIP  .CMD 

==>  LOADER.H06 

3.  LOADER. Hee  «>  OENCMD.CMD  =='>  L0ADER.CMD 

(8080  CODE[A400]) 

4.  LOADER.CMD  »«>  LDCOPT.CMD  ==>  LOADER.CMD 

(load  on  tracks  0  and  1) 


Figure  2.2 

Steps  For  Creating  Boot  LOADER.CMD 
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C.  BOOTSTRAPPING  TII  iSBC  86/12A 

from  the  monitor  of  the  iSBC  e6/12A,  the  CP/N  system 
loader  program  located  on  tracks  0  and  1  of  the  disk,  can 
be  accessed  via  the  bootstrap  or  cold  start  loader  program. 
This  program  is  located  in  ROM  or  BPROM  on  the  iSBC  66/12A 
board  itself.  Thus,  for  each  separate  device  from  which  the 
system  is  to  be  booted,  a  new  cold  start  loader  program  must 
be  written  and  then  burned  into  ROM.  finally,  this  ROM  must 
be  mounted  on  the  iSBC  86/12A  board  where  it  can  be  accessed 
by  the  monitor  program. 

Currently,  two  cold  start  loader  programs  are  available 
for  the  iSBC  86/12A.  One  allows  the  system  to  be  booted 
from  either  the  single  or  double' densi  ty  Intel  liDS  floppy 
disk  drive  system  by  executing  the  command  GffD4:0  from  the 
iSBC  86/12A  957  monitor  program.  When  this  command  is 
executed,  the  program  in  the  ROM  will  go  out  to  tracks  0  and 
1  of  the  floppy  diskette  and  attempt  to  bring  into  memory 
the  CP/M  system  loader  program.  Once  loaded  into  memory, 
the  cold  start  loader  will  then  transfer  control  to  the 
loader  which  in  turn  will  locate  the  CP/M  system  (CPM.STS) 
on  the  disk  and  load  it  into  memory.  Finally,  the  system 
loader  will  relinquish  control  to  the  CP/M  operating  system. 
The  source  code  for  this  bootstrap  program  is  listed  in 
Appendix  C  of  Reference  1. 

The  second  program  allows  bootloading  from  tne  M3B-80 
bubble  memory  device  by  issuing  the  command  GFFD4;4. 
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Currentlx  this  l«st  command  can  onljr  be  used  vhen  operating 
on  the  iSBC  86/12A  which  is  labeled  #1,  as  it  is  the  only 
computer  with  an  BPROM  that  contains  the  cold  start  loader 
for  the  bubble  memory.  The  source  code  for  this  program, 
which  was  deweloped  by  Bichlin  and  Neufeld,  can  be  found  in 
Appendix  D  of  Reference  2. 

This  thesis  uses  the  bubble  memory  to  initially  boot 
the  system.  Therefore,  a  new  cold  start  loader  program  or 
CP/M  system  loader  program  did  not  have  to  be  developed. 
All  that  Is  required  to  change  the  operating  system  that 
will  be  loaded  is  to  place  a  new  CP/M  system  (CPM.STS)  on 
the  bubble  memory  storage  device. 

The  loader  program  placed  on  tracks  0  and  1  of  the 
bubble  memory  used  for  loading  the  CP/M  operating  system  is 
entitled  MB80LDR.CMD.  This  file  is  created  by  following  the 
steps  indicated  in  Figure  2.2  utilizing  MPeeBICS  .Ae6  as  the 
source  file  with  the  loader  conditional  assembly  switch  set 
to  true. 

D.  DISK  PARAMSTER  TABLE 

The  CP/M-86  operating  system  as  marketed  by  Digital 
Research  is  considered  a  table  driven  system  since  all 
characteristics  for  each  I/O  device  is  placed  in  a  table 
called  the  Disk  Parameter  Table  which  can  handle  up  to 
sixteen  separate  devices.  This  table  defines  the  logical 
organization  of  the  physical  storage  media  for  the  BDOS  file 
management  functions  and  must  be  included  in  every  BIOS. 
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A  disk  deflBltion  statement  Is  required  for  each 
physical  derlce  and  consists  of  a  sequence  of  words  which 
define  the  characteristics  of  a  device.  Figure  2.3  shows 
the  format  of  a  disk  definition  statement.  These  statements 
are  then  used  to  generate  the  Disk  Parameter  Table  by 
executing  the  utility  program  entitled  GSNBEF.CMD  [Ref  6, 
p.727.  The  file  created  by  this  program  must  be  Included  in 


DISK  DEF:  dn,  fsc,  Isc,  [skf]  ,  bis,  dir,  cks,  ofs,  [0] 
where 

dn  is  the  logical  disk  number  (0  to  15) 

fsc  is  the  first  physical  sector  number  (3  or  1) 

Isc  is  the  last  logical  128  byte  sector  number 

skf  is  the  optional  skew  factor 

bis  is  the  data  allocation  block  size 

dsk  is  the  disk  size  in  bis  units 

dir  is  the  number  of  directory  entries 

cks  is  the  number  of  “checked'  directory  entries 

ofs  is  the  track  offset  to  logical  track  0 

(normally  2  as  track  0  and  1  contain  the  loader) 
[0]  is  the  optional  J.. 4  version  compatibility  flag 

Figure  2.3 

Format  of  Disk  Definition  statement 


the  BIOS  using  an  “iaclude“  statement.  The  file  which 
contains  the  disk  definition  statements  for  this  thesis  is 
labeled  CPMKAST.DEF  and  used  to  generate  a  Disk  Parameter 
Table  which  is  located  in  the  file  called  CPMMAST.LIB. 
These  two  files  can  be  found  in  Appendices  G  and  H. 

To  create  a  disk  definition  statement  for  the  table,  the 
characteristics  for  the  device  must  be  known.  This 
information  is  usually  located  in  the  technical  manuals  for 
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the  given  device.  Tor  ezemple*  the  disk  definition 
statement  used  for  the  BEMfX  Winchester  hard  disk  was: 

DISIDET  3,1,156«0,16384,2S5,128,0»1. 

The  first  **3"  indicates  that  the  hard  disk  is  CP/li's 
logical  drive  number  '*3*'  and  can  be  accessed  via  the  "D:" 
command  from  within  CP/M. 

The  next  two  numbers  correspond  to  the  first  and  last 
logical  sector  numbers  for  the  Winchester  hard  disk  as  seen 
by  CP/M.  The  actual  physical  sectors  for  the  hard  disk  are 
numbered  from  1  to  39,  each  containing  512  bytes.  Since 
CP/M  requires  the  number  of  logical  126  byte  sectors,  39  is 
multiplied  by  4  to  produce  156  logical  sectors  of  128  bytes. 
The  actual  mapping  from  the  logical  to  the  physical  sectors 
is  accomplished  in  the  blocking  and  deblocking  subroutines 
located  in  the  code  for  the  EEMEZ  hard  disk  (RZEARS.A86)  and 
is  described  in  more  detail  In  the  Chapter  IT. 

The  REMEZ  technical  manual  does  not  indicate  what  the 
most  effective  skew  factor  is,  thus  zero  was  chosen  because 
it  was  required  by  the  blocking  and  deblocking  routines. 
However,  an  optimal  skew  factor  may  be  determined 
experimentally  when  the  REMEZ  hard  disk  is  used  to  emulate 
the  "signal  processor"  of  the  AEGIS  system.  If  so,  the 
blocking/deblocking  routine  will  have  to  be  modified  at  that 


The  "his"  parameter  specifies  the  number  of  bytes 
allocated  to  each  data  block.  This  number  can  be  1024, 
2048,  4096,  8192,  or  16,384.  Vhen  larger  block  sizes  are 
used,  each  directory  entry  can  address  more  data.  This 
reduces  the  amount  of  work  that  the  BIOS  must  do,  resulting 
in  reduced  system  response  time.  Therefore,  a  block  size  of 
16,384  vas  chosen. 

The  "dsk"  specifies  the  total  disk  size  in  terms  of  data 
blocks.  It  is  derived  by  dividing  the  total  byte  capacity 
of  the  disk  by  the  data  block  size.  In  this  implementation, 
the  Winchester  disk  contains  approximately  20  megabytes  of 
data  storage  which  is  subdivided  between  four  separate 
heads.  Thus  4,193,280  bytes  are  allocated  to  the  "D:'*  drive 
and  this  figure  is  divided  by  16,364  to  produce  255  data 
blocks. 

The  next  figure,  126,  indicates  the  number  of  directory 
entries  that  are  permitted  on  this  drive. 

The  ”cks"  term  determines  the  number  of  directory  items 
to  be  checxed  on  each  directory  scan  and  is  primarily  used 
for  detecting  changed  disks  during  system  operations.  Ks 
the  Winchester  disk  is  permanently  mounted,  a  value  of  zero 
was  chosen  for  this  parameter. 

ihe  "ofs"  value  determines  the  number  of  tracks  to  be 
skipped  whan  accassing  the  disk.  In  essence,  it  reserves 
tracks  for  permanent  storage.  Track  2  is  reserved  since  the 
Hemex  reciuires  it  for  internal  system  use  and  errors  will 
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occur  if  an  attempt  is  made  to  access  it.  On  a  floppy  disJc, 
this  value  is  usually  two  as  tracics  0  and  1  are  normally 
reserved  for  the  loader  program. 

S.  TH£  STANDARD  BIOS 

The  BIOS  for  CP/M-86  always  begins  at  an  offset  of  2500 
hex  from  the  beginning  of  the  CP/M-86  operating  system.  At 
this  location  are  twenty-one  entry  points  used  by  the  CCP 
and  the  BDOS  to  gain  access  to  the  BIOS  functions.  These 
entry  points  form  a  jump  vector  to  other  subroutines  in  the 
BIOS  which  contain  the  necessary  code  to  interface  with  each 
hardware  device. 

There  are  three  types  of  functions  in  the  BIOS:  system 
initialization/reinitalization,  simple  character  I/C  and 
dish  I/O.  Several  of  these  functions  are  normally  not 
implemented  in  most  microcomputer  systems,  while  others 
require  extensive  and  quite  different  code  implementations 
for  each  separate  device.  The  BIOS  also  contains  the  Dish 
Parameter  Tables  which  represent  the  physical  description  of 
the  dish  drives.  Finally,  located  at  the  end  of  the  BIOS, 
there  is  a  scratchpad  area  for  certain  BDOS  operations. 
Figure  2.4  shows  the  memory  map  of  tne  BIOS. 

In  order  to  simply  access  a  dishette,  several  functions 
located  within  the  BICS  may  have  to  be  performed.  For 
example,  to  access  the  directory  of  a  dishette,  the  BDOS 
will  require  the  following  functions  to  be  performed  by  the 
BIOS:  SELDSI,  HOME,  SETTHE,  SETSEC,  SETDMA ,  SETD^AB  and 
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CS,  DS,  IS,  SS: 


CS  2500E: 
CS  +  253rH: 


rigure  2.4 

Memory  Map  of  the  Standard  BIOS 
# 

READ.  [Ref.  6:  p.60]  Eor  each  function  executed,  the  BIOS 
will  have  to  determine  which  physical  device  Is  being 
accessed  and  then  Jump  to  or  call  the  subroutine  which 
contains  the  code  for  that  specific  device.  For  example, 
suppose  a  simple  READ  function  Is  required  by  the  BDOS .  It 
will  Initiate  a  call  to  the  BIOS  READ  entry  point  welch  In 
turn  will  vector  the  call  to  the  READ  subroutine.  Here  the 
BIOS  will  determine  which  physical  device  corresponds  to  the 
CP/M's  logical  drive  and  then  Jump  to  the  appropriate  code 
to  read  data  from  that  specific  device.  (See  Figure  2.5) 
This  procedure  Is  very  logical  and  maices  It  easy  for  a 
user  to  Implement  his  specific  device  dependent 
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CCP - 

I - >  call  to  BIOS  to  Bead  Device 

BDOS - 


- - - 


BIOS:  jmp  inlt 
Jmp  write 

- >  JMP  READ - >- 


jmp  wboot  I 

I 

I 

- < - < - 

inlt: 

code  for  initiallzia^  all  devices 
ret 

vri te: 

code  for  writing  to  all  devices 
ret 

--> - READ: 

determine  device 
Jmp  read  device  #1 

JMP  READIdEVICE  #2  - > - 

Jmp  read_device  #3  I 

I 

read^device  #1: 

code  for  reading  device  #1 
ret 

— > - read  device  #2; 

CODE  FOR  READING  DEVICE  #2 

BET 

read_device  #3 

code  for  reading  device  #3 
ret 


Figure  2.5 

Path  of  CCP  or  BDOS  Function 
Call  in  the  Standard  BIOS 
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code.  However,  problems  arise  if  tiie  hardware  configuration 
must  be  altered.  Everytime  the  configuration  changes,  the 
code  for  each  function  in  the  BIOS  must  be  rewritten.  This 
can  be  a  time  consuming  task.  In  addition,  assumptions  made 
concerning  the  implementation  of  one  configuration  may  lead 
to  errors  in  another  configuration  should  those  assumptions 
no  longer  be  valid.  These  errors  may  also  be  extremely 
difficult  to  locate  and  correct  since  all  code  is  usually 
intermixed  and  the  exact  order  that  the  CCP  and  3D0S  call 
various  functions  in  the  BIOS  is  .not  known  to  the  user. 

F.  BIOS  ALTERATION 

Elcklln  and  Neufeld  attempted  to  develop  a  table  driven 
BIOS.  In  a  manner  of  speaking  they  succeeded.  However,  the 
only  .devices  that  are  permitted  in  their  devic'e  table  are 
additional  Intel  MBS  double  density  disk  drive  systems  and 
MBB-80  bubble  memory  storage  devices.  Attempting  to 
integrate  anotner  device  such  as  the  REMEX  Data  Warehouse, 
leads  to  the  same  problems  which  were  mentioned  earlier. 

To  alleviate  these  problems,  a  completely  table-driven 
BIOS  was  developed  in  which  only  minor  and  straight-forward 
changes  would  have  to  be  made  in  order  to  change  hardware 
configurations.  Tnls  was  accomplished  by  extracting  out  all 
the  device-dependent  functions  of  the  BIOS  into  separate 
files  for  each  unique  device.  Specifically,  these  functions 
were  INIT,  SELDSK,  HOME,  SELTRK,  SSLSEC,  READ,  and  WRITE. 
Functions  such  as  WBOOT  are  not  dependent  upon  a  particular 
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device  and  do  not  have  to  he  extracted*  while  functions  such 
as  PUNCH  and  READER  are  not  implemented. 

In  the  hardware  configuration  for  this  thesis*  three 
separate  files  were  required.  These  were  M360DSE.A&6* 
RXIL0P.A86*  RZEARD.A86.  These  files  each  contain  the 
necessary  code  to  execute  the  seven  device-specific 
functions  for  the  MBB-60  bubble  storage  device*  the  Remex 
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Figure  2.6 

i^emory  Map  of  the  Table-Driven  BIOS 


floppy  disk  drives,  and  the  Remez  hard  disk,  respectively. 
An  additional  file,  CPMMAST.C7G,  is  also  now  required.  It 
contains  tables  of  labels  which  correspond  to  the  physical 
tnetnory  location  of  the  seven  functions  for  each  device  used 
in  a  given  hardware  configuration.  The  label  tables  used  in 
this  thesis  can  be  found  in  Appendix  C.  Figure  2.6  shows 
the  memory  map  of  the  table  driven  BIOS.  In  the  BIOS,  the 
assembly  language  Instruction  "include"  is  used  to 
Incorporate  the  label  tables  and  device-specific  code  for 
the  seven  functions  into  the  system. 

■ 

For  example,  when  a  call  is  made  to  read  Device  #2  from 
the  CCP  or  the  BDOS,  the  call  is  vectored  as  was  done  before 
through  the  Jump  vector  to  the  READ  subroutine  of  the  BIOS. 
However,  after  determining  the  physical  device  to  be 
accessed,  instead  of  Jumping  directly  to  the  desired  code,  a 
call  is  now  made  to  the  device  specific  code  located  in  the 
Included  device's  AS6  file  via  the  Read  Table  which  is 
located  in  the  file  CPMMA3T.CFG.  The  final  address  of  the 
call  is  determined  by  the  offset  of  device  number  into  the 
Read-Table,  which  provides  the  label  or  16-blt  address  of 
the  actual  code  needed  for  reading  Device  #2.  (See  Figure 
2.7 ; 

To  alter  the  hardware  configuration,  only  one  line  in 
the  BIOS  must  now  be  changed  for  each  device,  that  being  the 
corresponding  "include"  statement.  The  other  changes  which 
are  required,  are  located  in  the  label  tables  and  the  Disk 
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Figure  2.7 

Path  of  CC?  or  BDOS  Function 
Call  in  Table-Driven  BIOS 


Parameter  Tables.  For  each  device  Included  in  the  BIOS, 
there  must  be  a  corresponding  label  for  an  abstracted 
function.  These  labels  must  be  correctly  ordered  and 
properly  identified.  Naturally,  when  hardware  is 
implemented  into  the  system  for  the  first  time,  the  initial 
code  for  performing  the  seven  device-specific  functions  must 
be  written.  But  once  written,  the  new  device  can  be  added 
or  deleted  from  the  operating  system  with  very  little 
effort.  The  fact  that  all  code  for  each  device  is  completely 
independent  of  other  devices,  aids  in  detecting,  locating 
and  correcting  errors.  Actual  experience  has  shown  that 
once  the  code  for  a  device  has  been  written,  going  from  one 
hardware  configuration  to  another  can  be  accomplished  in 
under  twenty  minutes. 


III.  HASS VARS 


A.  GENERAL  HARDWARE  CONEIGURATION 

The  hardware  configuration  utilized  in  this  thesis 
consists  of  four  iSlC  86/12A  Single  Board  Computers,  a  MBB- 
60  Buhbl-Board,  a  32E  byte  common  memory  board,  and  the 
BEKEX  Data  Warehouse  memory  storage  device  with  Multibus 
Interface  Card  Assembly.  The  components  are  all  Multibus 
compatible  and  were  placed  in  an  iCS-Sa  Industrial  Chassis 
for  system  operation.  Figure  3.1  depicts  the  physical 
hardware  configuration.  Table  3.1  describes  the  logical-to- 
physlcal  mapping  between  the  CP/M  representation  of  the 
system  and  the  actual  physical  hardware. 
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Figure  3.1 

Physical  Hardware  Configuration 


Table  3.1 

Logical  Eardvare  Configuration 


1  CP/M's  Logical 
!  Device  Number 

1 

1 

1 

t 

Actual 

Drive 

Actual 

Physical  Device 

1  0 

A: 

MBB-60  Bubble  Memory 

1  .  .  L  .  1 

!  1 

B: 

Remex  Floppy  Disk  Drive 

1  2 

C  : 

Remex  Floppy  Disk  Drive 

!  3 

D: 

Remex  Hard  Disk  Head  0 

1  4 

E: 

Remex  Hard  Disk  Head  1 

i  5 

F: 

Remex  Hard  Disk  Head  2 

^  6 

G: 

Remex  Hard  Disk  Head  3 

B.  INTEL  e6/12A  SINGLE  BOARD  COMPUTER 

The  Intel  iSBC  86/12A  Single  Board  Computer  is  a  complete 
computer  system  constructed  entirely  on  a  single  Multibus- 
compatible  circuit  board.  It  is  designed  to  operate  as  a 
standalone  system,  a  bus  master  in  a  single  bus  master 
system,  or  a  bus  master  in  a  multiple  bus  master  system. 

The  board  Itself  contains  an  Intel  6066  16-blt 

microprocessor,  64S  bytes  of  dynamic  RAM  memory,  16K  bytes 
of  EPROM  memory,  both  serial  and  parallel  I/O  ports,  a 
programmable  timer  and  interrupt  controller,  and  a  Multibus 
Interface  controller. 

Onboard  RAM  memory  is  located  between  0  and  0ffffh  and 

the  EPROM  between  JEC00h  and  FFEFEh  within  the  1-Megabyte 

address  space  available  to  the  Intel  6066  microprocessor. 
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If  the  local  processor  attempts  to  address  memory  outside  of 
these  ranges,  a  Multibus  access  will  result.  The  onboard 
SAM  is  dual-ported,  and  therefore  is  accessible  to  the  local 
processor  via  an  internal  bus,  as  well  as,  to  any  external 
Multibus  master  via  the  Multibus.  In  this  latter  case,  the 
onboard  RAM  is  operating  in  the  SAM-Slave  mode.  Any 
collisions  that  result  when  the  SAM  is  simultaneously 
accessed  by  the  local  CPU  and  the  Multibus  are  resolved  by 
hardware  in  favor  of  the  local  CPU. 

Vhile  the  location  of  SAM  relative  to  the  local 
processor  is  fixed  between  0  and  FIPFh,  it  can  be  switch- 
and-  Jumper  configured  into  any  126K  segment  of  the  1- 
Megabyte  address  space  relative  to  the  Multibus.  In 
addition,  none  or  all  of  the  onboard  HAM,  in  segments  of 
16S,  may  be  reserved  strictly  for  local  CPU  use.  Since  the 
major  objective  of  this  implementation  was  to  produce  a 
CP/M-based  multicomputer  system  in  which  each  computer 
operates  totally  independently  of  the  others,  each  iSBC 
36/12A  was  configured  to  make  all  of  the  onboard  RAM 
Inaccesible  to  the  Multibus. 

C.  MBB-80  BUBBLE  MSMOST  STORACE  DEVICE 

!•  SEBEIAl  fe^EIlSliRQ 

The  M3B-00  Bubbl-Board  is  a  complete  bubble  memory 
storage  device  designed  to  be  compatible  with  all  8-  and  16- 
bit  microcomputers  that  utilize  Intel's  Multibus 
architecture.  The  board  consists  of  eight  (8)  TI30203 
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bubl)le  devices  and  the  necessary  control,  buffering,  and 
Multibus  interface  logic.  The  host  CPU  interfaces  with  the 
MBB-60  controller  via  memory-mapped  I/O  utilizing  any 
sixteen  (16)  consecutive  user-defined  addresses  within  the 
1-Megabyte  system  address  space.  These  sixteen  (16) 
addresses  correspond  to  the  sixteen  (16)  registers  in  the 
bubble  memory  controller  that  are  utilized  in  support  of  the 
following  controller  primitive  commands: 


Fill  Buffer 
Empty  Buffer 
Write  Single  Page 
Read  Single  Page 
Write  Multiple  Pages 


Read  Multiple  Pages 

Initialize 

Read  Status 

Enable/Bi  sable  Interupts 
Reset 


Read  and  write  operations  with  the  MB3-80  are 
accomplished  by  specifying  a  particular  bubble  device  number 
and  page  number  (18  bytes)  to  read  from  or  write  to.  The 
MB3-60  controller  provides  the  ability  to  ’•ead  or  write  in 
either  a  single-  or  multiple-page  mode  by  using  a  byte-by¬ 
byte  transfer  into  a  FIFO  buffer  located  on  the  MBB-8«}  board 
Itself.  The  single-page  mode  can  be  implemented  in  a 
stralght-foward  manner  without  the  need  for  addtional 
supporting  hardware  or  software.  However,  the  multiple-page 
mode  requires  that  certain  timing  requirements  must  be 
adhered  to  by  the  host  CPU  when  communicating  with  the  MBB- 
60  controller.  During  a  data  transfer,  the  host  must 
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respond  to  interrupts  generated  bjr  the  MBB>e0  every  160 
microseconds  which  signal  the  completed  transfer  of  one  byte 
of  Information  in  a  multi-byte  transfer.  These  interrupts 
can  be  generated  on  the  Multibus  and  handled  by  the 
Programmable  Interupt  Controller  (PIC),  or  the  host  CPU  can 
poll  the  controller  interrupt  register  (offset  0fh)  to 
determine  if  an  interrupt  has  occurred.  The  single-  and 
multi-page  polled  modes  were  implemented  by  Hichlin  and 
Neufeld  [Eef.  2].  The  final  version  of  their  system 
utilized  the  multi-page  polled  mode  and  this  was 
subsequently  employed  in  this  implementation. 

3.  CP^Mr86  Compatibility 

In  order  to  effect  a  data  transfer,  the  MBB-80 
controller  must  be  given  a  device  and  initial  page  number  to 
locate  the  position  where  the  data  will  be  read  from  or 
written  to.  On  the  other  hand,  CP/M  uses  a  trach  and  sector 
number  to  access  data  during  a  dish  access.  Therefore,  a 
mapping  must  be  made  from  the  CP/M  trace  and  sector  number 
to  MBB-80  device  and  page  numbers  if  the  C?/M  operating 
system  is  going  to  be  used  to  access  data  on  the  MBB-80 
Bubbl-Board.  Hlcklln  and  Neufeld  [Ref.  2]  decided  to  use 
the  bubble  page  number  as  the  smallest  addressable  unit  for 
each  data  transfer  and  the  basis  for  the  MEB-60  memory 
organization.  Since  each  physical  bubble  page  is  eighteen 
(18)  bytes  long,  a  logical  CP/M  sector  of  128  bytes  consists 
of  eight  (8)  bubble  pages  of  which  the  last  sixteen  (16/ 


bytes  on  the  last  page  are  not  used  (l.e.  wasted). 
Therefore*  the  640  bubble  pages  per  device  are  mapped- into 
80  logical  CP/M  sectors  per  device.  Futhermore*  it  was 
decided  that  each  MBB-’80  "tracfc**  would  consist  of  26  sectors 
which  corresponds  to  the  number  of  sectors  per  track  on  a 
normally-formatted  single-density  floppy  disk.  Another 
design  decision  was  that  all  MBB-80  traciES  would  be 
completely  contained  on  a  single  bubble  device.  Since  there 
are  26  CP/M  sectors  per  track  and  80  sectors  per  bubble 
device*  this  results  in  three  (3)  tracks  per  bubble  device 
with  two  (2)  sectors  not  used  or  wasted  on  each  device. 
Therefore,  based  on  these  design  decisions*  tne  total 
capacity  of  the  MBB-80  Bubbl-Board  is  78K  bytes  on  24  tracks 
(6  devices  x  3  tracks  per  device)  with  a  total  of  14k  bytes 
wasted.  Hicklin  and  Neufeld's  final  memory  organization  for 
the  MBB-e0  is  shown  in  Figure  3.2.  Disp’ite  its 
inefficiency,  this  configuration  was  adopted  for  this 
implementation  since  the  principal  function  of  the  bubble 
memory  is  to  provide  a  convenient  method  of  booting  CP/M-86 
on  our  master  iSBC  86/12A.  Hammond  [Ref.  3]  has  shown  that 
there  is  a  more  efficient  way  to  organize  the  MBB-80  in  his 
work  on  utilizing  the  M'BB-80  as  a  snared  resource  in  a 
multi-microcomputer  system.  However,  this  would  have 
necessitated  the  design  and  implementation  of  a  new 
bootstrap  loader  program  to  be  placed  in  the  ISBC  66/12A 


SPROM  and  was  not  judged  to  be  of  significant  importance  for 
this  implementation. 
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MBB-80  Logical  Storage  Or^janization 
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D.  RSMEX  DATA  WAREHOUSE 

1 •  5fi5§rii  Pfiscript Ion 

The  REMEZ  Data  Warehouse  Is  a  mass  storage  memory 
unit  containing  a  fixed  Winchester  disk  drive,  two  (2) 
flexible  diskette  drives  (single-  or  double-sided),  and  a 
microprocessor  controller  that  services  all  drives.  The 
memory  capacity  of  the  fixed  disk  is  approximately  20 
megabytes  and  the  flexible  diskettes  can  be  formatted  to 
contain  up  to  two  (2)  megabytes  of  storage.  IBM  standard  EM 
encoding  is  used  for  the  single  density  floppy  diskette 
while  MEM  encoding  is  utilized  for  the  double  density 
diskette  and  the  hard  disk. 

The  fixed  disk  is  a  14  inch  enclosed  disk  utilizing 
Winchester  technology  and  is  composed  of  two  recording 
surfaces.  Each  surface  has  two  (2)  recording  heads  which 
can  each  access  a  total  of  213  tracks.  Each  track  can 
contain  up  to  24K  bytes  of  information.  However,  only  210 
tracks  can  be  referenced  for  normal  read/write  operations. 
The  bard  disk  sector  size  is  switch-selectable  to  either 
128,  256,  512,  or  1024  bytes  per  sector.  The  total  storage 

capacity  for  the  various  sector  sizes  is  shown  in  Table 
3.2.  In  addition,  the  floppy  diskette  controllers  are  also 
switch-selectable  to  handle  either  single  or  double  density 
diskettes.  It  is  extremely  important  that  these  switch 
setting^  fiPirejponi  ejaptly  to  the  actugl  format  of  the  h^rd 
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Table  3.2 

REMEX  Hard  Disk  Sector  Selections 


1  Sector  Size 

Sectors/Track 

1  Capacity 

1 

1 

i  128 

104 

1  10. 7M  bytes 

1 

1 

I  256 

1 

1 

67 

1  14. 4M  bytes 

1 

1 

1  512 

39 

;  16 .8M  bytes 

1 

1 

1  1024 

21 

1  18. IM  bytes 

1 

1 

disk  and  diskette  for  the  rgad^write  ogerations  to  fungtign 
cgrregtljf . 

The  HEMSI  Data  Warehouse  (RDW)  is  designed  to 
transfer  all  data  and  command  structures  to  and  from  the 
host  computer  via  direct  memory  access  (DMA).  To  initiate  a 
RDW  operation,  the  host  computer  builds  a  command  packet 
within  its  local  memory.  This  packet  contains  all  the 
Information  necessary  to  effect  an  RDW  operation.  The  host 
then  sends  the  address  of  the  command  packet  to  the  RDW  via 
an  interface  board  utilizing  programmed  I/O.  When  the  .RDW 
is  ready  to  accept  packets,  it  inputs  the  command  packet  via 
DMA,  performs  the  required  function,  and  transfers  any  data 
via  DMA.  When  the  function  is  complete,  the  RDW  indicates 
this  by  noting  it  in  the  command  packet  status  word  or  by 
generating  an  interrupt  on  the  Multibus.  Packets  can  be 
queued  in  the  RDW  up  to  a  maximum  of  eight. 

Some  other  Important  features  of  the  RDW  include: 

—  Dynamic  data  buffering  (2K  x  16  bit  buffer) 


allows  a  continuous  transfer  under  varying  CPU 
conditions. 

—  Dynamic  buffer  protects  against  data  overrun  and 
underrun  preventing  loss  of  data  without  host 
computer  Intervention. 

—  Allows  data  transfers  In  large  blocks  of  up  to 
641  words  with  a  single  command.  Heads  are 
automatically  advanced  as  necessary. 

— Automatically  seeks  to  track(s)  required  in 
command  packet . 

—  Permits  chaining  packets  together  in 
noncontlnuous  memory. 

—  Ability  to  format  entire  disk  with  a  single 
command . 

— Automatic  verification  and  assignment  of 
alternate  tracks  to  cover  bad  tracks. 

2.  Cpmmaad  Basket  CEginlzalion 

The  basic  structure  of  the  command  packet  is  shown 
in  Figure  3.3.  Word  0  is  composed  of  a  modifiers  section,  a 


function 

code 

block  ,  and 

a  logical 

uni  t 

section . 

The 

function 

code 

block  specifies  which 

of 

the  six 

(6) 

particular 

REMEX  functions 

is  to  be 

performed . 

These 

funct ions 

are 

Read,  Write 

,  Write  ID 

and 

Record , 

Copy, 

Format,  and  Maintenance. 
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Bit  Number 


word  0  I 


1  I 

2 

3 

4 


15  8  7  4  3 

Modifiers  I  Function  I  Logical  Unit 
Status  Vord 


0 


Last  Word 


Figure  3.3 

Command  Packet  Description 


A  program  in  the  RDW  interprets  the  function  number 
and  determines  how  many  words  are  required  for  each  specific 
command  packet.  The  modifiers  section  contains  information 
on  packet  chaining,  program  control  interrupts,  disabling  of 
error  routines  and  an  "end"  marker  which  specifies  a  single 
packet  or  the  last  packet  in  a  packet  string.  The  logical 
unit  can  be  either  0,  1,  or  2.  A  zero  always  corresponds  to 
the  hard  disk.  However,  the  floppy  diskette  drive  can  be 
operator-configured  to  respond  to  either  logical  unit  number 
1  or  2.  This  is  accomplished  by  the  Device  Logical  Unit 
Switch  located  on  the  front  panel  of  the  RDW. 

The  status  word  is  divided  into  the  least 
significant  bits  (3-7)  and  the  most  significant  bits  (6-15). 
Each  of  the  least  significant  bits,  when  set  to  (1), 
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•  Table  3.3 
RSMEZ  Error  Codes 


1 

1 

Bit  No.  1 

Description 

1 

1 

0  i 

Normal  Completion 

1 

1 

1  1 

Not  Assigned  i 

1 

1 

2  ! 

Controller  Error  1 

1 

1 

3  1 

Drive  Error  i 

1 

! 

4  i 

CRC  Error  1 

i 

i 

5  1 

Illegal  Packet  i 

\ 

1 

6  1 

Bad  Track  During  Format  1 

1 

i 

7  ! 

Not  Assigned  1 

represects  a  particular  status  which  is  indicated  in  Table 
3,3  Bits  a-  13  represent  the  hex  code  that  corresponds  to 
the  error  definitions  given  in  Table  3-6  of  Reference  7. 

Words  2  through  N  are  function  dependent  and  the 
number  of  words  per  command  packet  varies  widely  between  RDW 
operations.  In  the  version  of  CP/M  developed  in  this  thesis, 
only  the  Read/Write  function  are  implemented  and  are  used  to 
access  and  transfer  data.  However,  additional  utility 
programs  were  written  which  utilize  the  other  functions  to 
format  the  hard  disk  (RXPORMAT.CMD)  and  to  execute  the 
built-in  maintenance  programs  (RXMAINT.CMD)  of  the  RDW. 

The  format  of  the  Read/Write  packet  is  shown  in 
Figure  3.4.  The  description  of  these  two  operations  is 
identical  except  that  in  a  read  operation  a  one  il)  is 
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Bit  Number 


15 

8  7  4  3 

0 

Word  0 

1 

t 

Modifiers  i  Function  {  Unit 

i 

1 

1 

1 

1 

Status  Word 

1 

1 

2 

1 

1 

Track  Number 

1 

1 

3 

1 

1 

Head  Number  !  Sector  Number 
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1 
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1 

1 

Memory  Address  of  Data  (16-bit) 

1 

1 

5 

1 

f 

}  Ext  Memory  Addr  Bits 

1 

1 

6 

1 

1 

Transfer  Word  Count  (#  of  16-bit  words) 

1 

1 

Figure  3.4 

REnEZ  Read/Vrite  Pacicet 


placed  in  the  function  code  block  of  packet  word  3  and  for 
a  write  operation  a  two  (2)  is  used.  Both  operations  are 
permitted  in  blocks  of  up  to  64Z  words,  kny  head  switching 
or  advancing  which  may  be  required  is  automatically 
performed  by  the  RDV  disk  controller. 

RDW  track  numbers  are  assigned  from  1  to  210  for 
normal  data  transfer  operations.  Track  0  is  always  reserved 
for  a  loader  or  system  program  and  can  not  be  addressed 
during  a  normal  read  or  write  operation  without  generating 
an  error.  Presently,  the  hard  disk  is  formatted  for  512 
bytes  per  sector  which  corresponds  to  39  sectors  per  track. 
Head  numbers  for  the  four  RDW  heads  run  from  3  through  3. 
Data  addresses  are  a  24-bit  representation  of  the  20-bit 
address  structure  supported  by  the  iSBC  86/12A  and  Multibus 
architecture.  The  transfer  word  count  is  the  number  of  16- 
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bit  words  that  are  to  be  transferred.  For  accessing  the 
hard  dlsJc,  a  transfer  word  count  of  100h  was  placed  in  the 
packet  built  by  CP/M.  This  figure  corresponds  to  a  single 
sector  (512  bytes)  or  256  16-blt  words  on  the  hard  dlslc« 
which  is  equivalent  to  the  CP/M-86  Operating  System  view  of 
512  8-bit  words. 

3.  Multibus  Interface  Card  Assembly 

The  command  packets  are  sent  to  the  RBW  via  a 
Multibus  Interface  Card  Assembly.  The  interface  contains 
all  the  necessary  buffers*  registers  and  control  logic 
required  for  the  transfer  of  data,  status,  addresses  and 
commands  between  the  REMSX  Data  Warehouse  and  the  iS3C 
a6/12A  Single  Board  Computer.  Tne  interface  operates  in  both 
a  programmed  I/O  mode  and  a  DMA  mode.  All  data,  status,  and 
commands  are  transferred  by  DMA,  while  packet  addresses  and 
the  interface  Command/Status  information  are  transferred  via 
programmed  I/O.  During  these  transfers,  the  Multibus 
Interface  acts  as  a  bus  master  in  the  DMA  mode  and  as  a  bus 
slave  in  the  programmed  I/O  mode  [Ref.  8].  Registers  are 
provided  for  data,  packet  address  holding,  and  DMA 
addresses.  A  DMA  address  counter  (20  oits)  allows  memory 
addressing  of  up  to  1-Megab/te.  Control  logic  for  DMA,  bus 
timing,  interrupt  control  and  device  address  selection  is 
also  provided.  Selection  switches  are  available  to  alter 
the  Interface  base  address.  Interrupt  priority  level,  and  the 


DMA  throttle  which  governs  how  long  the  interface  must  wait 
between  DMA  transfers. 


In  the  programmed  I/O  mode  of  operation,  the 
Multibus  Inteface  responds  only  to  I/O  port  addresses. 


Swi tches. 

as 

mentioned 

above 

,  are 

used  to 

set 

the  base 

interface 

port 

address. 

The 

standard  addresses 

for  the 

Command/Status 

Register 

are 

port 

address 

070 

(least 

significant  byte)  and  port  address  071  (most  significant 
byte).  The  standard  addresses  for  tne  Pachet/DMA  Register 
are  port  addreses  072  and  073.  A  more  thorough  description 
of  the  contents  of  these  registers  is  given  in  Table  3-2  of 
Reference  7. 

The  DMA  Throttle  Select  is  used  to  select  the  number 
of  Multibus  accesses  that  must  be  completed  between 
consecutive  DMA  transfers  by  the  Multibus  Interface.  A 
selectable  range  of  3-15  transfers  is  provided.  The  standard 
is  1  host  Multibus  cycle  between  interface  DMA  cycles.  This 
is  contrary  to  the  explanation  given  in  Section  2.3.3  of 
Reference  7.  In  this  section,  the  DMA  throttle  is  presented 
in  terms  of  "number  of  processor  cyles"  instead  of  Multibus 
accesses. 

4.  Commaad  PiS^et  Sxecutloa 

To  execute  an  operation  contained  in  a  command 
pachet,  the  host  computer  must  first  test  the  Packet  Address 
Ready  Flag  (port  070)  which  indicates  whether  the  RDW  is 
ready  to  accept  and  process  command  packets.  If  this  flag 


is  set  (l)t  the  host  loads  the  extended  address  bits  (bits 
17-20)  of  the  command  packet  into  the  Command/Status 
Register  (port  070).  Then  the  least  significant  byte 
followed  by  the  most  significant  byte  of  the  16-bit  address 
of  the  command  packet  must  be  loaded  into  tne  Packet/SMA 
Register  (ports  072  and  073  respectively).  This  sequence 
must  be  followed  exactly  because  once  the  most  significant 
byte  is  loaded  into  port  073,  the  interface  board  signals 
the  RDW  that  the  address  is  complete  and  ready  to  be 
transferred. 

Upon  receiving  this  signal,  the  RDW  will  read  the 
address  which  was  placed  in  the  ports  of  the  interface 
board,  fetch  the  command  packet  located  at  that  address,  and 
perform  the  operation  specified  in  the  function  code  blocs 
of  the  packet.  When  the  operation  is  complete,  an  entry  is 
made  into  the  command  packet  status  word  (word  0)  indicating 
the  success  or  failure  of  the  operation. 

E.  ICS-S0  INDUSTRIAL  CHASSIS 

The  lCS-80  Industrial  Chassis  consists  of  four  ,  four- 
slot  iSBC  604/614  Cardcages,  four  fans,  a  power  supply,  a 
control  panel  and  a  19"  RETMA  (Radio-Electronics-Televislon 
Manufacturers  Association)  -compatible  chassis.  The  control 
panel  consists  of  an  on/off/lock  key  switch,  interrupt  and 
reset  pushbuttons,  and  halt/pwr  on/run  LSD's. 

The  development  system  was  designed  to  support  a  modular 
microcomputer- based  system.  Any  combination  of  plug-in 


modules  which  are-  Multihus-compatlhle  may  he  Installed 
Including  single  hoard  computers*  memory  expansion  hoards 
and  peripheral  interface  hoards.  The  iSBC  604  Cardcage  can 
accomodate  four  (4)  iSBC  circuit  hoards  and  has  an  external 
plug  which  allows  additional  iSBC  614  Cardcages  to  he  added 
to  the  chassis.  The  laboratory  system  used  in  support  of 
this  thesis  is  composed  of  a  single  1S3C  604  Cardcage  and 
three  (3)  iSBC  614  Cardcages  which  allow  a  total  of  16 
circuit  board  slots.  These  cardcages  comprise  a  hachplane 
assembly  that  conforms  to  the  Intel  Multibus  specifications 
and  provides  slots  for  both  Mutihus  master  and  slave  hoards. 
The  master  slots  are  odd-numbered  and  the  slave  positions 
are  even-numbered  for  easy  reference. 

A  master  board  is  one  which  is  capable  of  acquiring  and 
controlling  the  Multibus,  while  a  slave  board  can  only  be 
referenced  by  commands  on  the  Multibus  (i.e.  memory 
expansion  boards).  The  ICS -60  Chassis  can  be  used  with 
.Taster  boards  operating  in  either  a  serial  or  parallel 
priority  resolution  scheme.  In  the  serial  mode.  Multibus 
access  contention  Is  resolved  by  the  board  placement  within 
the  cardcage.  However,  an  external  priority  resolver 
networlx  is  required  to  implement  the  parallel  priority 
scheme.  In  this  Implementation,  a  random  priority  network  is 
used  to  arbitrate  the  contentions  for  the  Multibus.  Most 
importantly,  one  of  tae  above  priority  resolution  schemes 
must  be  Implemented  or  the  interaction  among  the  iS3C  boards 
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in  the  cardcages  will  not  he  correct, 
information  consult  References  9,  10,  and  11 


For  further 


IV.STSTgM  DEVILOPMENT 


A.  INITIAL  EFFORTS 

1*  Program  PgvelflBPfBl  Szsifim 

During  the  Initial  stages  of  this  thesis,  it  was 
planned  to  expand  the  work  done  hy  Hicklin  and  Neufeld  [Ref. 
2]  to  incorporate  the  REMEZ  Data  Warehouse  memory  storage 
unit.  They  nad  developed  a  reconf igurable  "table-driven” 
CP/M-e6  BIOS  that  supported  the  MBB-80  Bubbl-Board  and  the 
Intel  1202  double-density  floppy  disk  controller.  It  was 
initially  believed  that  other  I/O  peripheral  devices  could 
be  easily  included  in  this  BIOS  with  a  minimum  of  effort. 
Within  the  proposed  development  system,  the  MBB-00  would 
serve  as  the  principal  storage  medium  for  newly  designed 
programs  and  would  provide  an  easy  method  of  booting  HicJClln 
and  Neufeld's  CPM.STS  within  the  iCS-60  chassis. 

However,  this  development  strategy  bad  several 
deficiencies.  Utilizing  this  hardware/operating  system 
conf Igura tlon,  program  development  would  be  limited  to  the 
MDS  or  lCS-60  systems  and  the  CPM-86  utility  programs  which 
they  supported.  Presently,  the  only  compatible  text  editor 
available  is  the  text  editor  distributed  by  Digital 
Research,  ED.CMD.  This  editor  Is  very  primitive,  extremely 
hard  to  use,  and  completely  unsatisfactory  for  extensive 


program  development.  Therefore,  an  alternative  development 
system  was  required. 

It  was  decided  to  use  the  WORDSTAR  text  editor  on 
the  MP/M  Multi-user  System  to  create  the  needed  software 
programs.  This  system  provided  several  advantages  over  the 
MDS  system.  First,  WORDSTAR  offers  functions  which  would 
significantly  increase  productivity  and  allow  errors  to  be 
quickly  corrected.  Second,  MP/M-compa tl ble  versions  of  ASM- 
66  and  GZNCMD  utilities  would  enable  programs  to  be  written, 
assembled,  corrected,  and  converted  into  executable  CMD 
files  prior  to  their  transfer  to  the  bubble  memory.  Third, 
since  the  MP/M  system  is  a  multi-user  system,  it  did  not 
present  the  availability  problems  associated  with  the 
single-user  systems  such  as  MDS. 

Ultimately,  this  software  development  scheme  also 
proved  to  be  unsatisfactory,  as  numerous  steps  had  to  be 
taken  to  move  an  assembled  program  from  the  MP/M  system  to 
the  MBB-60  board.  Since  only  MP/M  and  MDS  single  density 
diskettes  were  compatible,  assembled  programs  first  bad  to 
be  transferred  from  the  MDS  single  density  system  to  the  MDS 
double  density  system  using  the  laboratory  utility  program 
SDXFBR.COM.  This  required  that  the  MDS  double  density  system 
be  configured  with  an  Intel  S060  processor.  Once  the 
program  was  transferred  to  a  double  density  diskette,  the 
MDS  double  density  system  had  to  be  reconfigured  for  use 
with  the  MBB-60  bubble  board  and  an  iSEC  S6/12A.  After 
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reconfiguring*  the  program  could  now  be  transferred  from  the 
double  density  diskette  to  the  bubble  memory.  At  this  point 
the  MBB-80  was  physically  moved  to  the  iCS-80  chassis. 
Finally,  the  operating  system  could  be  loaded  and  the 
program  executed  under  DDTe6. 

Besides  being  time  consuming,  the  above  process 
monopolized  much  of  the  laboratory's  equipment.  Thus,  if 
the  equipment  needed  to  make  the  transfer  was  in  use, 
program  testing  could  not  be  carried  out.  However, 
initially,  it  was  the  only  method  available  and  therefore 
had  to  be  employed. 

2*  Igrlfy  M3B-83  Operation 

The  objective  of  this  section  was  to  verify  the 
proper  operation  of  the  CPM.STS  developed  by  Eicklin  and 
Neufeld.  The  double  density  MDS  system  was  configured  with  a 
single  iSBC  66/12A  (#1),  the  MBE-6e  bubble  memory,  and  the 
1202  Floppy  Disk  Controller.  The  system  was  successfully 
booted  from  the  957  Monitor  in  accordance  with  the 
procedures  given  in  Reference  11  by  executing  the  command 
GFFD4:0.  However,  the  bubble  memory  could  not  be  accessed 
using  any  of  the  CP/M  built-in  commands.  After  inspection 
of  the  BIOS,  it  was  evident  that  the  final  version  of  the 
CP/M-ee  BIOS  submitted  did  not  support  the  MBB-eO . 
Therefore,  the  CPM.STS  had  to  be  reconstructed. 

The  files  LKP5M.DFF  and  CONFIG. DEF  were  first 
checked  to  ensure  that  the  desired  hardware  configuration 
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was  accurately  reflected  in  the  Disk  Definition  Tables,  the 
Disk  Tables,  and  the  Bubble  Tables.  Once  this  was  completed, 
'the  file  MBBI0S.A66  was  reassembled  and  was  then 
concatenated  with  CPM.E86  using  PIP.COM.  The  resulting  hex 
file  was  then  converted  to  an  executable  CMD  file  and 
renamed  CPM.STS. 

To  ensure  that  all  possible  errors  were  avoided 
prior  to  system  initialization,  it  was  decided  to  reformat 
the  MBB-S0.  The  program  MB60FMT.CMD  was  executed,  inserting 
3000h  as  the  MBB-a0  controller  base  address.  Once 
formatted,  the  CP/M  loader  program  MB80LDR.CMD  was  placed  on 
tracks  0  and  1  of  the  MBB-e0  utilizing  the  LDCOPT.CMD 
utility.  The  reconstructed  system  was  booted  and  functioned 
normally. 

3.  Mpdlflpation  of  the  BIOS  for  Use  in  the  ICSrS? 

As  envisioned  in  the  program  development  process, 
new  programs  would  be  transferred  to  the  MDS  double  density 
system  using  a  laboratory  utility  program.  These  programs 
could  then  be  placed  on  the  MBB-60.  The  MBB-80  would  then 
have  to  be  physically  moved  to  the  iCS-60  chassis.  By 
entering  the  command  (JIFD4:4,  CP/M-86  could  be  booted  and 
the  programs  executed  under  CP or  BDT86.CMD.  However, 
since  the  MB3-S0  would  be  the  sole  memory  storage  device  in 
the  lCS-80  chassis,  a  new  modified  BIOS  had  to  be 
construct  ed. 
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The  changes  that  needed  to  he  made  vere  located  in 
two  major  areas  of  the  BIOS.  First,  the  file  DSPBM.BFF  which 
contained  the  disk  definition  statements  for  each  logical 
CP/li  disk  drive  had  to  changed.  The  number  of  logical 
devices  was  changed  to  1  and  the  disk  definition  statement 
for  the  !iBB-80  was  entered  as  CP/M  logical  drive  0  (Drive 
A;)  indicating  tTiat  the  MBB-e0  was  the  only  "drive”  in  the 
system.  The  other  changes  were  made  to  the  Disk  and  Bubble 
Tables  contained  in  the  file  CONFIC.DIF.  Eic^lin  and 
Neufeld  had  created  these  tables  to  identify  whether  CP/M 
logical  drive  numbers  where  either  MBB-90  devices  or  1202 
controllers.  These  tables  would  support  any  hardware 
configuration  of  MBB-80's  and  1202  contollers  up  a  total  of 
16  disk  drives  (maximum  for  CP/M).  However,  other  peripheral 
devices  such  as  the  3EMEX  Data  Warehouse  could  not  be 
supported  as  was  initially  believed. 

Once  these  change*^-  nad  been  made,  the  BIOS  was 
reassembled  and  used  to  create  a  new  CPM.STS  which  was 
placed  on  the  bubble  memory.  It  was  subsequently  tested  and 
it  functioned  normally. 

4.  RSMEX  LQW-Lgv§l  Routines 

Concurrently  with  the  work  on  the  M3B-80,  low-level 
read/write  routines  were  written  and  executed  which  accessed 
the  REMEX  Data  Warehouse  memory  storage  unit.  This  work  was 
accomplished  on  the  iCS-80  chassis  using  an  iSBC  86/12A 
single  board  computer  and  the  REMSX  Multibus  Interface  Card 


Assembly.  At  first  only  the  most  primitive  operations  were 
performed,  since  there  was  no  permanent  memory  in  the 
system.  Using  th$  957  Monitor  program,  small  programs  were 
executed  to  examine  the  various  values  contained  in  tne 
Interface  status  registers.  Once  the  new  MBB-60  CPM.STS  was 
available,  more  comprehensive  programs  were  written  which 
could  build  command  packets,  transmit  command  packet 
addresses  to  the  interface  board,  and  chec.-c  the  packet 
status  word  for  function  completion.  The  basic  logic  of  the 
read/write  functions  was  discussed  in  greater  detail  in 
Chapter  3  and  the  logic  diagram  Is  saown  in  Figure  4.1. 

A  command  packet  was  built  which  would  write  a  very 
simple  set  of  characters  to  a  particular  head,  track,  and 
sector  number  of  the  REMEX  hard  disk  or  a  track  and  sector 
number  on  the  floppy  diskette.  Using  DDT66.CMD,  the  commana 
packet  was  then  altered  to  produce  a  read  operation  which 
would  retrieve  the  previous  message  from  the  RCW  and  write 
it  to  a  selected  memory  address.  CDT66.CMD  was  also 
extensively  used  to  monitor  packet  construction  and  memory 
content.  With  each  successful  transfer,  larger  blocks  of 
data  were  transferred  until  it  was  concluded  that  the 
operations  were  being  correctly  performed.  Although  some 
progress  was  made,  the  program  turn-around  time  resulting 
from  the  lack  of  an  adequate  development  system  definitely 
Impeded  further  progress. 
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5.  Tdbl€r£riv£Q  £XCS 

The  development  mechanism  that  had  been  used  up  to 
this  point  was  tedious  and  time-corn suming.  The  time 
required  to  repair  errors  discovered  while  working  on  the 
iCS-80  was  too  excessive  to  support  cohesive  program 
modification.  It  also  became  evident  that  the  concepts  used 
by  Hicklln  and  Neufeld  In  the  development  of  their  BIOS  were 
not  sufficient  to  meet  the  objectives  of  this  thesis. 
Although  it  was  presented  as  a  model  for  a  very  flexible 
system,  the  BIOS  actually  only  supported  MBE-SB  bubble 
memories  and  1202  floppy  diskette  controllers.  Inclusion  of 
additional  peripheral  devices  would  have  required  major 
modification  to  the  BIOS.  Furthermore,  even  if  these 
modifications  were  made,  each  time  a  device  was  added  or 
deleted  from  the  system,  the  code  within  the  BIOS  for  the 
individual  function  calls  would  have  had  to  be  changed.  The 
many  inconveniences  of  the  program  development  procedure 
coupled  with  the  limitations  of  the  Hicklin  and  Neufeld 
approach  in  a  varying  hardware  environment  necessitated  a 
new  BIOS  design  strategy. 

Hammond  [Ref.  3j  had  Identified  that  certain  device 
specific  code  could  be  extracted  from  the  "core"  of  the  BIOS 
without  affecting  function  operation.  This  was  accomplished 
by  indirectly  vectoring  BIOS  calls  to  the  proper  subroutines 
via  a  table  of  labels.  Hammond  had  extracted  the  RSAD, 
WRITE,  and  INIT  BIOS  functions  and  constructed  the 
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appropriate  tables  In  a  separate  file  named  CONflG.SEF. 
This  file  vas  then  assembled  with  the  BIOS  by  means  of  an 
“include’*  statement. 

Next,  let  us  examine  the  EEAC  function  in  greater 
detail  to  see  exactly  how  this  BIOS  works.  Figure  4.2 
contains  the  code  for  the  BEAD  function  In  the  "core"  BIOS 
for  a  hardware  configuration  consisting  of  an  1201  Floppy 
Disk  Controller. 


read: 

zor  bz,bz 
mov  bl,unlt 
add  bz,bz 
call  readtblLbz] 
ret 

Figure  4.2 

Table-Driven  BIOS  Head  Code 

# 

This  controller  supports  two  floppy  disz  drives 
which  correspond  to  CP/M  logical  drives  0  and  1.  This 
correspondence  is  set  up  in  the  Disk  Definition  Tables.  Also 
prior  to  the  3D0S  call  to  the  BIOS  HEAD  function,  the 
desired  drive  number  has  been  stored  in  a  BIOS  variable 
called  "unit".  The  value  of  "unit"  is  first  placed  in  the 
"bl"  register.  Next,  it  is  doubled  since  each  label  in  the 
read_table  represents  the  16-bit  address  of  the  device¬ 
specific  read  functions,  A  call  is  now  made  to  the 
read_table  using  the  offset  contained  in  the  "bi"  register. 
This  table  entry  then  indirectly  addresses  tne  appropriate 
subroutine  for  the  desired  "unit".  For  example,  if  CP/M 
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the  read  call  is 


logical  drive  1  (B:)  is  selected* 

Indirectly  addressed  to  the  subroutine  label  located,  at  an 
offset  of  two  (2)  in  the  read_table.  The  read_table  is 
shown  in  Figure  4.3.  Notice  that  since  both  CP/M  logical 
drives  are  floppy  disk  drives,  the  read  call  is  vectored  to 
the  same  subroutine . 

readtbl  dw  offset  12ei_read 
dw  offset  i2iai_read 

Figure  4.3 
BIOS  Read  Table 

Through  the  use  of  a  table-driven  BIOS,  the 
configuration  flexibility  needed  for  this  application  could 
be  achieved.  The  use  of  the  indirect  call  allows  all  device 
specific  code  to  be  isolated  in  a  single  file.  Therefore,  a 
separate  file  can  be  constructed  for  each  unique  peripheral 
device  and  can  be  Included  in  the  BIOS  by  the  use  of  the 
"include”  assembly  command.  An  additional  benefit  of  this 
type  of  approach  is  that  it  allows  for  the  systematic 
addition  or  deletion  of  hardware  devices  to  or  from  the 
system  without  disturbing  the  basic  BIOS  code. 

The  table-driven  concept  also  provided  an  improved 
program  develpment  scheme  and  a  more  logical  approach  for 
the  Implementation  of  the  ESMEX  Data  Warehouse  memory  unit. 
Hammond  had  previously  written  the  code  to  support  the  Intel 
1201  Floppy  Disic  Controller.  A  spare  1201  controller  was 
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aYdilable  and  was  placed  in  the  lCS-80  chassis.  With  a  few 
minor  modifications  to  the  BIOS,  it  was  operational  in  a 
very  short  time.  Since  both  ALTOS  and  MBS  sin^le’-density 
dislcettes  were  fully  compatible,  programs  could  now  be 
written,  assembled,  and  converted  to  executable  code  and 
then  be  taken  directly  to  the  iCS-80  for  execution.  This 
reduced  the  amount  of  time  needed  to  correct  errors  or 
modify  a  program  and  greatly  facilitated  code  generation. 

Because  devices  could  be  added  to  the  BIOS 
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independently,  it  was  decided  to  utilize  the  1201  floppy 
disk  drive  as  a  developmental  aid  and  to  subsequently 
implement  the  REMEX  floppy  disk  first  followed  by  the  hard 
disk.  The  MBB-80  would  be  substituted  for  the  1201  once  the 
REMEX  interface  was  completed.  This  implementation  scheme 
is  explained  in  more  detail  In  the  following  sections. 

3.  INTERFACING  THE  REMEX  DATA  WAREHOUSE 
1 •  flfiEEZ  Pisg  PriY? 

During  the  testing  of  the  initial  REMEX  READ/WRITE 
low-level  routines,  it  was  observed  that  the  REMEX  would 
only  intermittently  complete  a  packet  operation.  Ween  it 
did  not  complete  successfully,  the  program  looped  infinitely 
checking  the  packet  status  word  (see  Figure  4.1)  for  a  value 
other  than  a  zero,  indicating  that  the  REMEX  had  either 
completed  the  operation  or  that  an  error  had  occurred.  When 
multiple  packets  were  sent  out  on  the  Multibus,  completion 


codes  vere  occasionally  returned  in  the  command  packet 
status  word.  When  DDT86  was  used  to  trace  through  the  Read 
routine  step  by  step,  the  same  results  vere  obtained. 
However,  this  procedure  did  verify  that  command  packets  vere 
being  constructed  properly  and  that  the  packet  address  was 
being  transmitted  to  the  Multibus  correctly. 

Next,  a  Multibus  Monitor  Board  was  used  to  observe 
the  action  on  the  Multibus  and  confirmed  that  all  data  was 
correct.  This  led  to  speculation  that  either  the  interface 
board  was  not  transmitting  the  correct  information  to  the 
REMEX  or  the  REMEI  was  not  processing  packets  correctly  once 
it  received  the  information  from  the  interface  board. 
However,  further  hardware  testing  revealed  that  both  the 
REMEI  and  the  Interface  were  functioning  normally. 

The  source  of  the  problem  was  found  more  by  accident 
than  by  design.  Documentation  [Ref.  8  :  p.  2-4]  indicated 
that  the  Interface  Assembly  would  wait  from  e  to  15  host  CPU 
cycles  between  consecutive  DMA  operations.  The  exact  number 
of  cycles  can  be  Jumper  selectable  by  the  DMA  Throttle. 
Therefore,  polling  the  packet  status  word  for  a  completion 
code  was  thought  to  provide  sufficient  CPO  cycles  to  allow 
the  process  to  continue.  However,  when  the  wiring  diagram 
of  the  Interface  Card  Assembly  was  examined,  it  was 
discovered  that  the  DMA  Throttle  was  controlled  by  the 
number  of  Multibus  cycles  and  not  by  the  number  of  CP'J 
cycles.  Since  the  Throttle  was  set  to  the  factory  default 


position,  one  additional  Multibus  cycle  was  required  before 
the  interface  board  could  execute  its  next  DMA  operation. 
Because  there  was  only  a  single  host  computer  in  the  system, 
no  additional  Multibus  accesses  were  made.  This  explains 
why  marginal  success  was  obtained  by  sending  multiple 
packets  since  this  provided  the  additional  Multibus 
accesses.  The  DMA  Throttle  Jumper  was  removed  which  allowed 
the  Interface  Card  Assembly  to  respond  immediately  with  a 
DMA  operation  once  it  acquired  control  of  the  Multibus. 
Subsequent  pacXet  operations  were  successfully  completed. 

Once  the  READ/WRITE  driver  routines  had  been 

debugged,  the  next  step  in  the  floppy  disk  implementation 

was  to  incorporate  these  routines  into  the  table-driven 

BIOS,  A  separate  "include"  file  called  RIFlOPl .Ae6  was 
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established  to  contain  the  necessary  device-specific 
subroutines.  Of  the  seven  BIOS  functions  that  had  to  be 
addressed,  only  the  HEAD  and  WHITE  functions  required  code 
in  addition  to  that  contained  in  the  basic  BIOS  routines. 
Each  of  the  other  functions  were  returned  directly  to  tne 
main  BIOS. 

The  command  packet  was  allocated  memory  space  in  the 
data  section  of  RIELOPl.ASe.  However,  the  packet  parameters 
had  to  be  supplied  from  the  BIOS  variables  in  order  to 
access  the  file  requested  by  the  CP/M  file  manager.  Figure 
4.4  depicts  the  READ  packet  for  the  RZMEX  floppy  disk  drives 
used  in  this  implementation. 
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Bit  Number 
8  7  4  3 


word  0 


10h  II  i  1/2 


Status  Word 


Track 


Sector 


DMA  Buffer  Offset 


Figure  4.4 

REMEZ  Floppy  Disk  Read  Packet 


From  Chapter  3,  recall  that  word  2  of  the  command 
packet  is  composed  of  a  rrodifiers  section,  function  code 
block,  and  unit  id  number.  The  value  of  10h  in  the  modifiers 
section  merely  indicates  that  a  single  packet  is  being  sent 
and  that  all  automatic  error  routines  are  in  effect.  The 
function  code  block  (1)  specifies  a  READ  operation.  Since 
the  REMEX  floppy  disk  drives  were  chosen  to  be  equivalent  to 
CP/M  logical  disk  drives  1  and  2  (B;  and  C:)  for  this 
implementation,  the  CP/M  drive  number  and  the  REMEX  unit  id 
for  the  two  floppy  disk  drives  were  equivalent.  Therefore, 
the  desired  CP/M  disk  number  is  directly  inserted  into  the 
packet.  The  16  -bit  BIOS  variable  "track”  which  contains  the 
requested  track  number  is  placed  into  word  2  of  the  command 
packet.  Word  3  which  contains  the  head  and  selected  sector 
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number  is  formed  by  Inserting  a  zero  in  the  upper  byte 
indicating  that  the  floppy  diskette  ttill  only  be  addressable 
on  a  single  side  and  placing  the  BIOS  variable  "sector"  in 
the  lower  byte.  The  20-blt  address  of  the  CP/M  DMA  buffer 
which  will  receive  the  requested  data  is  computed  from  the 
DMA  base  and  offset.  The  extended  address  bits  (bits  16-19) 
are  entered  in  the  lower  byte  of  word  5.  For  example,  if 
the  local  memory  of  an  ISBC  96/12A  is  conflsured  to  respond 
to  Multibus  memory  segment  zero,  the  extended  address  bits 
will  be  equal  to  00h .  However,  if  the  local  memory  were 
configured  to  respond  to  Multibus  memory  segment  1000,  then 
the  extended  bits  would  be  01h.  The  remaining  16-bit  address 
is  placed  into  word  4  of  the  command  packet. 

Word  6  which  contains  the  transfer  word  count  caused 
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the  most  problems  with  the  floppy  disk  interface.  The  major 
difficulty  encountered  was  the  direct  result  of  poor  and 
misleading  documentation.  The  RSMEX  technical  manual  for 
the  interface  board  indicates  [Ref.  8  :  p.  2-4]  that  the 
REMEI  can  selectively  transfer  data  to  the  host  computer  in 
either  8-blt  or  16-blt  words  by  setting  a  single  switch. 
Since  CP/M  works  with  8-bit  words,  the  switch  was  set 
accordingly  and  a  transfer  word  count  of  126  8-bit  words  was 
placed  in  the  packet  and  sent  to  the  REMSX.  At  first,  this 
seemed  to  work  correctly  because  a  directory  of  the  diskette 
was  read  without  difficulty  and  files  could  be  transferred 
to  and  from  the  diskette  without  error.  However,  problems 
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were  encountered  when  attempting  to  execute  a  file  that  was 
on  the  diskette.  An  error  message  of  “FILE  NOT  FOUND"  was 
displayed  intermittently.  If  a  file  was  found,  the  program 
would  not  execute  correctly.  In  both  cases,  the  system 
partially  crashed  and  no  other  operations  could  be 
accomplished,  despite  the  fact  that  the  prompt  character 
continued  to  function  normally  along  with  an  occasional 
error  message. 

The  source  of  the  problem  was  not  readily  apparent. 
The  operating  system  worked  correctly  until  the  directory 
of  the  RZMFX  floppy  diskette  was  obtained  or  a  file  was 
executed.  However,  no  error  code  was  being  generated  by 
the  REMEX.  In  fact,  the  success  code  that  was  being 
generated  Indicated  that  the  operation  and  data  transfer  was 
be' eg  correctly  accomplished.  Executing  the  routines  using 
DDT86  also  indicated  that  the  REMSX  was  functioning 
correctly  and  showed  that  the  data  was  being  placed  in  CP/M 
DMA  buffer. 

Numerous  changes  and  experiments  were  made 
attempting  to  locate  the  cause  of  this  problem.  Printouts 
of  the  diskette's  directory  were  obtained  without  error. 
Hardware  was  tested  and  retested  with  negative  results. 
Finally,  a  memory  map  of  the  operating  system  was  printed 
after  obtaining  the  directory  from  a  diskette  in  the  MDS 
single  density  disk  drive  system.  This  was  compared  to  a 
memory  map  of  the  operating  system  after  the  directory  of 


the  same  diskette  was  taken  from  the  REMZX  floppy  drive.  It 
was  here  that  the  error  was  uncovered.  The  REMEZ  was 
transferring  256  8-hit  words  into  the  DMA  buffer  space,  not 
the  126  8-bit  words  as  believed.  Thus,  the  extra  data  was 
overwriting  portions  of  the  CP/M-86  BIOS  causing  the  system 
to  partially  crash.  The  problem  stems  from  the  fact  that 
the  REMEZ  wants  to  know  how  many  16-bit  words  it  should 
transfer.  This  Is  completely  independent  of  how  the  RSMSX 
will  transmit  the  data.  Therefore,  since  a  C?/M  sector  of 
128  bytes  is  equivalent  to  64  or  40h  16-bit  words,  40h  ,was 
placed  in  word  6  of  the  command  packet  and  no  further 
problems  were  encountered. 

2.  Hard  Disk 

Although  the  implementation  of  the  hard  disk  was 
very  similar  to  the  floppy  disk  drives,  there  were  some 
notable  exceptions.  First,  the  RSMSZ  had  a  sector  size  that 
was  a  multiple  of  the  standard  CP/M  sector  size  of  128 
bytes.  This  necessitated  the  use  of  a  sector 
blocking/deblocking  routine  to  resolve  this  disparity. 
Second,  since  the  REMEZ  hard  disk  has  four  (4)  separate 
heads,  the  question  of  how  to  divide  up  the  disk  had  to  be 
resolved.  The  most  logical  and  stralghtf oward  method  was  to 
let  each  head  represent  a  separate  CP/M  logical  disk  drive. 
Each  drive  would  then  be  able  to  address  up  to  4.5  megabytes 
of  data.  With  these  ideas  in  mind,  the  hard  disk  interface 
was  begun . 


Changes  had  to  he  made  to  the  Sisk  Definition  and 
Configuration  Tables.  In  the  file  CPMMAST.DBF,  CP/M  logical 
drive  numbers  3»  4*  5t  nnd  6  were  added  to  the  table.  Each 
drive  number  had  a  disk  definition  statement  that  described 
the  physical  storage  capabilities  of  a  single  head  of  the 
hard  disk.  The  disk  definition  variables  were  determined  as 
presented  in  Chapter  3.  Now,  the  BIOS  would  support  a  total 
of  seven  (7)  peripheral  I/O  devices:  an  1201  floppy  disk 
drive,  two  REMEX  floppy  disJt  drives,  and  four  RSMEX  hard 
disk  drives.  Later,  the  MBB-80  bubble  memory  would  be 
substituted  for  the  1201  disk  drive.  Also,  additional 
labels  had  to  be  added  to  the  tables  in  the  file  CPMMAST.CPC 
to  vector  the  BIOS  function  calls  to  the  appropriate 
subroutines  located  in  the  "include**  file  RXHARD1.A66. 

The  most  difficult  obstacle  to  overcome  in  this 
portion  of  the  Implementation  was  to  determine  the  REMEX 
hard  disk  sector  size.  The  sector  size  can  be  either  123, 
256,  512,  or  1024  bytes.  Initially,  attempts  were  made  to 
reformat  the  hard  disk  in  accordance  with  Reference  7. 
Switches  SI  and  32  located  on  the  Formatter  II  Card  Assembly 
were  set  to  configure  the  hard  disk  with  a  512  byte  sector 
size.  A  program  was  then  written  which  built  a  command 
packet  to  execute  the  REMEX  built-in  formatting  routine 
[Ref.  7  :  p  3-20].  However,  repeated  attempts  failed  to 
produce  a  successful  format  operation.  The  RSMEX  also 
supports  a  built-in  maintenance  program  that  tests  the  Hard 


Disk  Format  operation.  When  this  program  was  run,  multiple 
error  messages  were  returned  indicating  that  the  format 
program  was  inoperative. 

Since  data  had  been  written  to  and  retrieved  from 
the  hard  disk  during  low-level  driver  testing,  it  was 
obvious  that  the  EEMFZ  had  been  previously  formatted.  The 
next  step  was  to  determine  exactly  wnat  format  was  used. 
This  was  not  as  easy  as  might  be  expected.  During  the  power 
up  sequence,  the  REliEI  will  check  the  sector  size  switches 
and  configure  its  internal  circuitry  to  process  sectors  of 
that  size  even  if  the  switch  postions  do  not  represent  the 
actual  format  of  the  hard  disk.  That  is  precisely  why  these 
switches  must  match  the  actual  physical  sector  size  in  order 
for  read/write  operations  to  work  correctly.  This  fact 
caused  considerable  confusion  in  the  interpretation  of  tae 
error  messages  obtained  by  attempting  to  access  the  border 
sectors  (104,  67,  39,  and  21  for  sector  sizes  of  128,  256, 
512,  and  1024  bytes  respectively).  However,  it  was  finally 
determined  that  the  sector  size  was  512  bytes. 

Since  the  REMEX  sector  size  was  a  multiple  of  the 
128-byte  CP/M  sector  size,  a  sector  blocking/deblocking 
routine  was  needed  to  coordinate  the  access  of  CP/M  sectors 
with  the  physical  sectors  of  the  hard  disk.  In  this  case, 
there  were  four  (4)  CP/M  sectors  contained  on  each  hard  disk 
sector.  On  each  BIOS  call,  the  CP/M-66  3DCS  includes 
information  that  can  be  used  to  provide  effective  sector 


blocking  and  deblocking.  The  sector  blocking/deblocking 
routine  used  in  this  implementation  is  distributed  by 
Digital  Research  in  skeletal  form  [Ref.  6  :  p.  70]. 

The  blocking/deblocking  algorithms  map  all  CP/M 
sector  read  and  vrlte  operations  through  an  intermediate 
buffer  called  "hstbuf".  The  size  of  this  buffer  is 
equivalent  to  the  EZMEX  sector  size  (512).  During  a  read 
operation*  a  512~byte  sector  of  data  is  read  into  the 
‘‘hstbuf"  or  host  buffer  from  the  RZMEI  hard  disk.  Since  the 
host  buffer  now  contains  four  CP /M  sectors,  the  desired  128- 
byte  sector  is  obtained  by  correctly  offsetting  into  the 
host  buffer.  This  data  is  then  transferred  to  the  CP/M  DMA 
buffer  defined  by  the  DMA  base  and  DMA  offset  variables. 
Similarly*  during  a  write  operation,  four  CP/M  sectors  are 
written  to  the  host  buffer.  The  data  is  then  transferred  to 
the  REMEX  hard  disk  and  stored  on  a  single  512-byte  sector. 

Within  the  blocking/deblocking  routine  itself,  the 
values  and  variables  which  relate  to  CP/M  sectors  are 
prefixed  by  "sek",  while  those  related  to  the  REMEX  hard 

disk  are  prefixed  by  "hst".  The  SELDSK,  SETTRK,  SETSEC, 

SECTRAN,  and  SETDMA  entry  point  routines  were  transposed 

into  the  REMEX  nard  disk  ’’include’'  file.  These  subroutines 

store  values  for  later  use  and  SECTRAN  translates  CP/M 
sector  values  into  the  corresponding  physical  sector.  The 
READ  and  WRITE  entry  point  labels  were  placed  in  the 
read_table  and  write_table  respectively,  while  the  actual 
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RBMEX  hard  disk  read  and  write  low-level  drivers  were 
incorporated  at  the  REASHST  and  WRITEHST  entry  points. 

The  command  packet  was  constructed  froir  the 
following  variables:  ’’hstdsk**  which  represents  the  host  disk 
number,  "hsttrk”  which  is  the  host  track  number,  and 
"hstsec**  which  cooresponds  to  the  host  sector.  The  host  disk 
number  is  transformed  into  the  appropriate  head  number  and 
is  entered  into  the  upper  byte  of  word  3  of  the  command 
packet.  The  memory  segment  and  offset  of  the  host  buffer 
(hstbuf)  is  translated  into  a  20-bit  address.  The  extended 
bits  (16-19)  are  entered  into  the  lower  byte  of  word  5, 
while  the  remaining  16-blt  address  is  placed  in  word  4  of 
the  command  packet.  Tor  the  REMEI  hard  disk,  we  want  to 
transfer  512  bytes  or  256  16-blt  words.  Therefore,  the 
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transfer  word  count  (word  6)  was  set  to  ledh.  The  RIMEI  hard 
disk  Read  packet  is  shown  in  Jif^ure  4.5. 

3.  ifiilisl  (jaltiriSSC  gS/124  SzstfiQ 

The  above  implementation  produced  a  CP/M-86  BIOS 
that  supported  the  MBB-eo  bubble  memory  and  the  RSMEZ  Data 
Warehouse  floppy  and  hard  disk  drives.  The  ori/rinal  master 
iSBC  86/12A  (#1)  was  booted  from  the  MBB‘‘88  and  had  its 
onboard  memory  switch-and-Jumper  selected  to  be  accessible 
from  the  Mulitibus  beginning  at  memory  segment  zero.  Data 
transferred  from  the  REMEX  would  be  put  directly  into  the 
CP/M  DMA  or  fiost  Buffers  via  DMA  operations.  The  next  step 
was  to  introduce  a  second  iSBC  86/12A  into  the  system  which 
would  also  utilize  the  CP/M-86  operating  system. 

It  was  decided  to  use  the  32X  common  memory  to  hold 
a  bootloader  program  that  could  be  usea  by  the  slave  iSBC 
86/12A  computers  to  boot  the  CP/M--86  system.  A  utility 
program,  LDCPM.A86,  was  written  to  place  a  copy  of  CP/M-36 
into  common  memory  which  was  especially  configured  for  the 
slave  computers.  K  second  utility,  LDB00T.A86,  was  used  to 
transfer  a  copy  of  the  bootloader  program  ( BOOT .A66  )  into 
common  memory.  The  resulting  common  memory  map  is  snown  in 
Figure  4.6.  CPMSLA7S.CMD  was  identical  to  the  CP/M-66  system 
used  for  the  master  ISBC  86/12A  except  that  it  supported  an 
iSBC  86/12A  whose  local  memory  was  accessible  from  the 
Multibus  beginning  at  memory  segment  1000h.  When  initiated 
from  the  iSBC  86/12A  monitor,  the  bootloader  program  would 
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Common  Memory  Map 


transfer  the  CP/M-86  slave  system  from  common  memory  into 
local  memory  heglnnlng  at  40:0000h.  Cnee  the  transfer  was 
complete,  control  would  he  passed  to  the  BIOS  to  initialize 
the  system.  It  mast  ngte^  that  ai.1  thesg  programs  must 
rssidfi  on  CP/M  logical  drive 

This  scheme,  although  utilizing  the  DMA  capability 
of  the  REMEZ  to  the  maximum  extent  possible,  would  require  a 
different  CPMSLA7E.CMD  file  for  each  ISBC  66/12A  added  to 
the  system.  Each  computer's  local  memory  would  have  to  be 
placed  in  a  separate  64K  bloch  within  the  one-megabyte 
address  space  available  to  the  Multibus  and  these  page 
numbers  would  be  have  to  be  entered  in  the  lower  byte  of 
word  5  in  the  command  packet.  This  organization  is  somewhat 


awhward  and  exhausts  a  large  portion  of  common  memory  if 


seyeral  computers  are  used.  Therefore,  a  more  acceptable 
alternative  was  needed. 

C.  SYNCHRONIZATION  AND  PROTECTION 

Synchronization  of  Rftad/Wrlte  Qpf rations 
With  two  active  iSBC  86/12A  computers  in  the  s/stem, 
the  synchronization  of  read/vrite  operations  had  to  be 
addressed.  Since  the  RSMSX  could  queue  up  to  eif^ht  (8) 
command  packets  internally,  it  was  Initially  felt  that  this 
feature  would  provide  adequate  synchronization  of  the  I/O 
requests  from  the  independently  operating  computers. 
However,  when  simultaneous  multiple  transfers  were  attempted 
between  the  CP/M  hard  disk  logical  drives,  sporadic  errors 
occurred.  Inspection  of  the  READ  and  WRITE  routines  in  the 
hard  disk  "include”  file  (RXEARD1.A66)  revealed  that  there 
was  nothing  to  prevent  a  clash  of  both  ISBC  86/12A  computers 
If  they  simultaneously  attempted  to  send  a  command  packet 
address  to  the  REMEX  Interface  Card  Assembly.  Since  the 
packet  addresses  were  sent  in  three  (3)  single-byte  Multibus 
transfers,  it  was  indeed  possible  for  the  values  sent  to  the 
interface  board  to  become  intermixed.  Also,  once  the  most 
significant  byte  of  the  packet  address  is  sent,  the 
interface  immediately  signals  the  REMEX  that  tne  packet 
address  is  complete  and  ready  to  be  transferred.  However, 
this  may  not  be  the  case.  Consider  the  case  where  computer 
#1  has  transferred  the  extended  address  and  the  least 
significant  bytes  of  the  packet  address  to  the  Pacicet/EMA 


Register.  Computer  #2  then  sends  the  extended  bits  of  its 
pachet  address.  Since  each  computer's  memory  begins  on  a 
different  page*  the  extended  bits  will  be  different  for  each 
ISBC  86/12A.  Computer  #1  now  regains  control  of  the  Multibus 
and  sends  Its  most  significant  address  byte.  The  Remex  will 
nov  read  the  packet  located  In  computer  #2's  address  space 
rather  than  the  packet  In  computer  #l's  address  space.  This 
will  certainly  cause  severe  problems. 

Initially,  the  section  of  code  used  to  send  out  the 
packet  address  was  Identified  as  a  critical  section.  A 
semaphore  was  then  defined  to  control  the  access  to  the 
critical  section.  In  order  that  all  active  ISlC  e6/12A 
computers  could  have  access  to  the  semaphore,  It  was  placed 
In  common  memory  and  could  take  on  a  value  of  either  0  or  l 
Indicating  that  the  resource  was  either  busy  or  free 
respectively.  If  It  was  a  1,  the  requesting  computer  would 
set  It  to  0.  send  the  three  bytes  of  the  packet  address,  and 
then  reset  It  to  1.  If  the  requestor  found  that  the 
semaphore  was  equal  to  0,  it  would  delay  and  then  recheck. 
This  checking  process  was  Implemented  using  the  LOCK  XCEG 
instruction  to  provide  exclusive  use  of  the  Multibus. 

When  simultaneous  multiple  file  transfers  were  again 
attempted,  errors  still  occurred  Indicating  that  there  was 
still  some  Interference  on  the  Multibus.  This  probably 
occured  when  the  registers  of  the  Interface  were  set  up  for 
a  DMA  data  transfer  and  a  packet  address  was  then  written 
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into  the  PacJcet/DMA  register  before  the  data  could  be 
transfered.  At  any  rate,  a  more  inclusive  synchronization 
scheme  was  required  to  ensure  that  a  single  iSBC  e6/12A 
read/vrite  operation  could  be  completed  without  encountering 
contention  from  the  other  computers  in  the  system. 

Since  it  was  desirable  to  have  all  iSBC  86/12A 
computers  configured  alike,  it  was  decided  to  adopt  a 
software  approach  to  the  synchronization  problem  rather  than 
the  conventional  monitor  approach.  The  method  chosen  was 
based  on  sequencers  and  eventcounts  [Bef.  12] 4  This  method 
is  modeled  after  the  "ticket/server"  system  used  in  many 
stores  where  services  are  performed.  When  the  customer 
arrives,  he  takes  a  numbered  ticket  and  then  waits  for  his 
number  to  come  up  before  being  served.  The  server  works  in 
ticket  number  order.  The  implementation  of  this  scheme  is 
very  straightf oward  and  had  been  previously  used  by  Hammond 
[Ref.  3].  Two  16-blt  counter  variables,  "ticket"  and 
"server",  were  placed  in  common  memory.  The  value  0  was 
reserved  for  the  ticket  number  indicating  that  another 
computer  was  presently  modifying  the  ticket  number. 
Exclusive  access  to  the  ticket  number  was  provided  by  the 
LOCK  ZCHG  instruction.  An  algorithmic  language 
representation  of  the  sequencer  routine  is  given  in  Figure 
4.7.  The  delay  used  in  the  Await  Subroutines  was  used  to 
prevent  Multibus  contention.  "Request"  is  called  prior  to 
each  read  or  write  operation  to  gain  exclusive  access  to  the 
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shared  resource.  Once  the  operation  is  complete,  "release** 
is  called  to  free  the  resource  by  incrementing  the  server 
number  which  allows  the  next  I/O  function  to  be  executed. 
When  the  sequencer  code  was  Implemented  into  the  read/write 
routines  for  each  of  the  peripheral  I/O  devices,  no  further 
errors  were  noted. 

2.  Common  Memory  Re§4/¥£ite  BQutiges 

As  alluded  to  earlier,  the  CP/M-86  BIOS  which  uses 
DMA  operations  to  transfer  data  between  the  iSBC  86/12A 
computers  and  the  Remex  Data  Warehouse  requires  a  unique 
BIOS  for  each  computer  in  the  system.  This  places  a  severe 
limitation  on  further  system  expansion  and  complicates  the 
system  configuration  control  requirements.  Futhermore.  this 
type  of  implementation  requires  that  at  least  a  portion  of 
the  iSBC  86/12A's  local  memory  be  accessible  to  the 
Multibus.  One  of  the  principal  goals  of  this  thesis  was  to 
provide  a  system  in  which  all  computers  were  isolated  from 
one  another.  Obviously,  this  implementation  does  not  support 
this  goal.  It  also  results  in  an  awkward  bootloader 
arrangement  in  common  memory  and  requires  that  all  versions 
of  CP/M-e6  needed  for  system  operation  be  accurately  updated 
should  any  changes  or  modifications  occur.  Therefore,  a 
more  acceptable  BIOS  implementation  had  to  be  found. 

The  resulting  implementation  routed  all  data 
transfers  through  a  common  memory  buffer.  The  size  of  this 
buffer  was  set  to  correspond  to  tne  largest  physical  sector 
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vithlQ  the  system  which  was  the  512-byte  sector  of  the  REMIX 
hard  disk.  The  additional  code  required  for  each  read/vrite 
routine  was  minimal  since  its  only  function  was  to  transfer 
a  given  amount  of  data  between  local  and  common  memory.  A 
data  flow  diagram  depicting  a  typical  read  operation  from 
the  REMEX  is  shown  in  Figure  4.8.  For  illustration,  consider 
a  CP/M  initiated  read  operation  from  the  REMIX  hard  disk. 
The  command  packet  will  be  constructed  as  before  except  that 
the  20-blt  common  memory  buffer  address  will  replace  the 
host  buffer  address  in  word  4  and  the  lower  byte  of  word  5 
of  the  packet.  This  will  result  in  the  desired  data  being 
read  into  the  common  memory  buffer.  When  this  operation  is 
complete,  the  requesting  iSBC  S6/12A  will  then  transfer  the 
data  in  tde  common  memory  buffer  to  the  host  buffer  located 
in  the  data  section  of  the  CP/M  BIOS.  This  procedure  is 
entirely  transparent  to  the  CP/M  BDOS.  A  write  operation  is 
similarly  completed.  First,  the  data  in  the  host  buffer  is 
written  to  the  common  memory  buffer.  Next,  a  pacicet  is  sent 


to  the  interface  which  transfers  the  data  from  common  memory 
to  a  specified  head,  track,  and  sector  of  the  hard  disk.  The 
required  changes  were  made  to  the  "include"  files  for  the 
MBB-80  Bubble  memory,  the  HEMSX  floppy  disk  drives,  and  the 
REMEX  hard  disk  drives  and  the  files  were  renamed 
MB80DSK.Ae6,  RXEL0B.A66,  and  RXEAR1).A&6  respectively.  These 
files  appear  in  Appendices  C,  D,  and  S. 

The  common  memory  routines  produced  several 
Improvements  to  the  overall  system  design.  First,  all  iSBC 
86/12A  computers  could  be  completely  isolated.  Each  of  the 
four  computers  used  in  the  system  was  jumper  configured  so 
that  all  onboard  memory  was  reserved  totally  for  local  CPU 
use  and  could  not  be  accessed  from  the  Multibus.  This 
provided  the  required  protection  for  each  computer's  local 
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Figure  4.9 

Common  Memory  Allocation 


iremory.  Second,  only  a  single  copy  of  the  CP/M-86  operating 
system  was  required  for  all  of  the  slave  computers  since 
data  transfers  were  locally  initiated.  In  fact,  the  only 
difference  between  the  slave  and  master  versions  involved 
the  initialization  of  the  synchronization  variables  and  the 
log-table.  A  memory  map  showing  the  configuration  of  common 
memory  is  presented  in  Figure  4.9. 

3.  DiSK  Vllte  Protection 

The  ticket/server  synchronization  routine  ensures 
toat  single  iSBC  e6/12A  read/write  operations  can  be 
completed  without  interference.  However,  this  is  not 
sufficient  to  provide  the  necessary  write  protection  to  the 
shared  devices  in  a  system  of  multiple  computers  each 
running  CP/f^-e6.  Consider  the  case  of  two  processors  trying 
to  write  to  the  same  CP/M  logical  disk.  CP/M  reads  the  disk 
directory  and  constructs  an  allocation  vector  in  the  BIOS 
that  indicates  the  logical  blocks  on  the  disk  that  have  not 
been  written  to  previously.  2ach  iSBC  66/lEA  then  proceeds 
to  write  its  data  file  to  the  unallocated  blocks  in 
sequential  order.  Although  the  individual  write  operations 
were  synchronized,  the  result  is  still  overwritten  and 
garbled  data.  Therefore,  this  implementation  institutes  a 
read/write  strategy  that  allows  all  computers  to  read  data 
from  all  the  shared  devices  but  only  write  to  a  single 
device  to  prevent  files  from  being  overwritten.  Moreover, 
it  was  also  desirable  to  be  able  to  select  an/  of  the  shared 

79 


devices  for  write  operations  from  each  of  the  four  system 
console  positions. 


A  logon  and  logout  procedure  was  developed  to 
control  the  write  access  to  the  various  peripheral  devices 
through  the  use  of  a  table  located  in  common  memory.  This 
table  has  a  entry  for  each  device  in  the  system  (Figures 
4.10  and  4.11).  Before  the  user  is  permitted  to  boot 
the  CP/M  he  is  asked  for  his  console  number  and  the  CP/M 
drive  that  he  wishes  to  log  onto  (write  to).  The  CP/M  drive 

A:  B :  C :  D:  I:  F:  (r : 

logtbl  I  MBB-e0 1  FLOPl  |  FI0P2  i  flASDl  i  fiARI)2 1  hAHDS  I BARD4 1 

Figure  4.10 
Login  Table 


E000:0000 


ticket  I  server  |  logtbl 


:0100 

:0300 


CP/M  Buffer 


Figure  4.11 

Final  Common  Memory  Configuration 

number  is  stored  in  a  local  variable  called  "user”  which  is 
used  as  an  offset  into  the  log  table.  The  log  table  is  then 
checked  to  determine  if  the  desired  disk  has  already  been 
logged  onto.  If  not,  the  console  number  is  entered  into  the 
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log  table  at  an  offset  corresponding  to  the  given  device. 
Otherwise y  the  user  is  asked  to  select  another  disk.  To  log 
out.  the  user  types  the  command  "logout"  which  places  a  zero 
(free)  in  the  log  table  at  an  offset  equal  to  the  user 
number.  Each  CP/M  logical  disk  drive  requires  its  own  copy 
of  the  log  out  routine  (LOGODT.CMD)  so  that  it  can  be 
executed  from  every  disk  drive. 

Within  the  BIOS,  when  a  write  operation  is 
requested,  the  variable  "user"  is  compared  to  the  CP/M 
logical  disk  number.  If  they  are  equal,  the  write  operation 
is  permitted  to  continue.  If  not,  the  user  is  informed  that 
write  operations  are  not  permitted  to  that  disk  drive.  This 
guarantees  *  that  no  two  iSBC  86/12A  computers  can  write  to 
the  same  shared  disk. 

D.  SUMM/LRT  OF  SYSTEM  GENERATION 

The  following  descriptions  provide  step-by-step 
procedures  on  how  to  create  the  BIOS  for  this  Implementation 
of  the  CP/M-66  operating  system,  how  to  step  up  the  MBB-S0 
bubble  memory  board  in  the  MDS  double  density  system,  and 
how  to  start  up  the  multi-user  CP/M-c6  system. 

1 •  System  Sios  C reati on 

a.  Develop  separate  files  for  each  I/O  device  being 
sure  to  address  the  seven  device  specific  functions  in  each. 
In  this  code,  before  any  Multibus  access  include  the 
command  "call  request"  and  upon  completion  of  a  Multibus 
access  Include  tne  command  "call  release". 
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t.  Ensure  that  all  I/O  is  accomplished  via  the 
common  memory  I/O  buffer  which  extends  from  EZ00:100  to 
S000:300.  Develop  a  transfer  routine  for  moving;  data  to  and 
from  the  common  memory  buffer  and  the  host  computer. 

c.  Decide  upon  the  logical  hardware  configuration 
as  will  be  seen  by  CP/M-ee.  Based  on  this  configuration, 
develop  the  Dish  Parameter  Table  which  will  be  used  as  the 
source  file  for  OSMDEP.CMD  to  produce  a  ”.LI3"  file.  Also, 
using  this  same  hardware  configuration  and  the  I/O  device 
files,  develop  the  label  tables  in  CPMMAST.CFO  for  the  seven 
device  specific  functions. 

d.  In  the  BIOS  use  the  "include"  command  for  all 
I/O  device  files,  the  label  table  (CPMMAST.CFG)  ,  and  the 
CiSK  Parameter  Table  ( CPMMAST  .LIB  ) .  The  files  STNC.Aeo  and 
LOGIN, Ac6  must  also  be  included,  but  ref^uire  no 
Todlf  Ications. 

e.  Assemble  the  BIOS  using  ASM66.COM.  Using 
ASM66.CMD  may  generate  forward  reference  errors  and  require 
the  rearrangement  of  some  included  files  in  the  BIOS.  Two 
assemblies  must  be  made.  The  first  must  be  assembled  with 
the  master  conditional  assembly  switch  set  to  true  in  order 
to  create  the  master  BIOS.  The  second  must  be  made  with  the 
switch  set  to  false  in  order  to  create  the  slave  BIOS. 

f.  Concatenate  the  resulting  hex  files  with  CPM.H86 
to  form  CPMMAST, H86  and  CPMSLAVE .HB6.  Use  the  CP/M  utility 


command  GENCMD.CMD  (GENCMD  CPMMAST  8090  code[a40])  to 
generate  the  executable  command  files. 

g.  Transfer  CPMMAST.CMD  to  the  MBB-80  bubble  memory 
board  as  CPM.STS.  Transfer  CPMSLAVE.CMD  to  drive  L:  of  the 
REMEX . 

2.  Seating  up  tfeg  ifl  the  MJS  System 

a.  Remove  the  Intel  8080  microcomputer  and  the 
associated  memory  boards  from  the  MBS  double  density  system. 

b.  On  the  iSBC  66/12A  #1,  place  the  switches  1-16 
and  8-9  on  DIP  switch  SI  in  the  closed  position.  Install  a 
Jumper  between  pins  127  and  126.  If  there  are  Jumpers  in 
place  for  the  cloci,  pins  103  and  105,  remove  them. 

c.  Insert  the  iSBC  *66/12A  #1  and  the  MBB-e0  board 
with  the  baclcplane  into  the  MBS  chassis. 

'  d.  Turn  the  power  to  the  l^DS  chassis  and  the  disk: 
drives  on.  Once  these  devices  are  running,  apply  power  to 
the  MBB-80  board  by  setting  the  memory  protect  switch  on  the 
backplane  to  the  "run"  position.  Now,  the  CP/M-86  operating 
system  can  be  booted  from  a  doable  density  diskette  by 
entering  the  command  GFFD4:0.  The  system  booted  should  be 
one  that  is  capable  of  addressing  the  bubble  memory  as  a 
diskette. 

e.  To  format  the  MBB-e0  bubble  memory  execute  tne 
program  MB80FMT.CMD  and  use  6000H  as  the  base  address  for 
the  controller.  Execute  LDCOPT.CMD  using  LDRMB8e.CMD  as  the 
source  file.  This  will  place  the  loader  on  tracks  0  and  1 
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of  the  MBB-80  bubble  board.  Flaally  transfer  CPMMAST.CMD  to 
the  bubble  as  CPM.STS. 

3.  Syst§in  In^tlaHz§tion 

a.  Insert  four  ISBC  86/12A  computers  into  the  iCS- 
80  chassis.  One  computer  must  have  a  Jumper  on  pins  103/104 
and  105/106.  These  connections  supply  the  clock  for  the 
Multibus.  All  computers  should  have  pins  112  and  114 
connected  by  a  Jumper  wire.  This  ensures  that  the 
computer's  local  memory  is  inaccessable  to  the  Multibus. 
Also  on  all  computers,  only  position  8-9  on  DIP  switch  SI 
should  be  closed.  All  ocher  positions  should  be  open. 
Finally,  insert  the  MB3-83  bubble  memory  board,  tne  32K 
common  memory  board  and  the  REMEX  Interface  board  into  the 
iCS-80  chassis. 

b.  Turn  the  iCS-S0  power  switch  on. 

c.  Power  up  the  REMEX  in  accordance  with  Ref.  7  and 
turn  the  MBB-80  memory  protect  switch  to  "on".  This  switch 
is  located  In  the  rear  of  the  lCS-80  chassis. 

d.  When  the  REMEX  hard  disk  has  timed  out  and  the 
ready  light  is  on,  enter  the  command  GFFD4;4  from  the 
console  attached  to  1S3C  86/12A  #1  to  boot  CP/M-a6  from  the 
MBB-S0.  The  synchronization  variables  and  the  log  table 
entries  will  be  initialized  in  common  memory. 

e.  Select  drive  D: 
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,  A  A  • 


f.  Execute  LPCPM  located  on  drive  E: .  Tills  will 
load  the  file  CPNSLA7E.CME  into  common  memory  starting  at 

g.  Execute  tEBOOT  located  on  drive  E:.  This  will 
place  the  file  BOOT. CHE  into  common  memory  starting  at 
S00O:400. 

h.  Now,  CP/M>86  can  he  hooted  on  any  iSBC  86/12A 
computer  hy  entering  the  command  OE000:0400  from  the  monitor. 

i.  '«hen  a  session  is  completed,  enter  the  command 
LOGOUT  to  Logoff  the  system. 
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7.  ESSULTS  AND  CONCLUSIONS 


A.  GENERAL  RESULTS 

The  ultimate  ^oal  of  this  thesis  was  to  develop  a  multi- 
computer  "protected”  CP/M-86-based  system  that  shared  memory 
storage  devices.  This  goal  was  accomplished  and  the 
resulting  code  is  located  In  the  Appendices.  The  major 
product  produced  by  this  thesis  Is  a  completely  operational 
multi-user  development  station.  The  CP/M  BIOS  is  completely 
table-driven  and  can  be  reconfigured  for  different  hardware 
configurations  in  under  twenty  minutes.  This  feature  alone 
is  a  significant  improvement  over  the  standard  BIOS  marketed 
by  Digital  Research.  In  addition,  It  should  be  quite  easy 
to  expand  the  current  system  to  permit  more  users  or  add 
additional  I/O  devices. 

The  system  provides  user  protection  in  several  forms. 
No  user,  once  logged  onto  the  system  can  destroy,  either  by 
design  or  by  accident,  anothers  user's  files  or  local  CPU 
memory.  However,  any  single  computer  can  destroy  common 
memory,  but  it  is  a  simple  matter  to  restore  it. 
Furthermore,  the  logon  and  logout  procedures  prevent  two 
users  from  simultaneously  logging  onto  and  writing  to  the 
same  CP/M  logical  disk  drive. 
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B.  EVALUATION  OT  THE  IKPLEHENTAT ION 

To  evaluate  system  performance*  two  tests  were 
conducted.  The  first  test  involved  assembling;  a  3K  and  then 
a  24E  file  with  a  single  computer  logged  onto  the  system. 
The  assembly  time  was  recorded  using  a  conventional 
stopwatch.  Next*  two  computers  were  used  to  simultaneously 
assemble  the  same  file*  followed  by  tnree  and  then  four 
computers.  The  results  of  the  test  are  shown  in  Table  5.1. 

Table  5.1 

REMEX  Assembly  Times  In  Seconds 


FILE 

ONE 

TWO 

THREE 

FOUR 

SIZE 

COmPUTBR 

COMPUTERS 

COMPUTERS 

COMPUTERS 

3K 

12.9 

22.1 

25. 1 

28.6 

24E 

211.1 

246.7 

257.3 

275.5 

Table  5.2 

MP/M 

Assembly  Times 

In  Seconds 

FILE 

ONE 

TWO 

THREE 

FOUR 

SIZE 

USER 

USERS 

USERS 

USERS 

3K 

22.3 

I 

I 

Z 

24K 

323.2 

I 

I 

I 

One  might  expect  that  two  computers  would  take  twice  as 
long  to  assemble  the  same  program  and  three  computers  three 
times  as  long.  Eowever,  except  for  the  initial  contention 
for  the  I/O  devices,  all  computers  could  assemble  the  files 
in  parallel.  This  accounts  for  the  fact  that  there  is  not  a 
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linear  relatlonsnip  between  the  nunber  of  computers 
operating  in  the  system  and  the  assembly  times. 

To  provide  a  means  of  comparlsont  an  attempt  was  made 
to  run  the  same  test  under  the  flP/M  operatln^r  system. 
However,  KP/M  would  not  permit  more  than  one  file  to  be 
assembled  at  the  same  time.  In  fact,  on  several  attempts, 
the  entire  system  crashed.  The  results  of  this  test  are 
shown  in  Table  5.2. 

The  second  test  Involved  a  file  transfer  utilizing  the 
CP/M-S6  utility  PIP.CMD.  Since  all  operations  were  I/O 
intensive,  this  test  represented  a  worse  case  scenario.  The 
first  run  consisted  of  transferring  a  16K  file  with  only  one 
computer  operating  In  the  system  and  recording  the  time  it 
took  to  complete  the  operation.  Then  two  and  finally  three 
computers  were  used  to  execute  the  Identical  PIP  command  at 
the  same  instant.  The  time  it  took  for  all  computers  to 
complete  the  task  was  recorded.  The  results  of  these  tests 


are  shown 

in 

Table  5.3.  The  "is" 

indicate 

that  it  was 

no  t 

possible 

to 

make  the  transfer 

because 

there  was 

an 

insuf  f  id  ent 

number  of  destination 

type  devices,  (i.e. 

Two 

computers  cannot  transfer  files  to  a  single  bubble  device  at 
at  the  same  time.) 

To  provide  a  comparison  for  the  above  results,  tne  same 
test  was  run  on  the  MP/M  system.  Altaough  tne  two  system 
configurations  are  different,  they  do  offer  some  basis  for 
comparison.  However,  in  the  MP/M  system,  only  operations 


Table  5.3 

BZMEX  Transfer  Tines  In  Seconds 


\ 


\  TO  i 
\  i 

FROM  \  1 

HARD 

DISK 

BUBBLE 

DEVICE 

FLOPPY 

DISK 

SINGLE  COMPUTER  EXECUTING  PIP 

HARD  DISK 

2.5 

5.6 

8.1 

3U33LE  DEVICE 

5.6 

8.0 

11.6 

FLOPPY  DISK  7.3  9.6  12.(3 


TWO  C0MPUT5RS  EXECUTING  PIP 


• 

HARD  DISK 

5.9 

X 

54.4 

BUBBLE  DEVICE 

11.3 

X 

54.6 

FLOPPY  DISK 

29.1 

X 

X 

THREE  COMPUTERS 

EXECUTING  PIP 

HARD  DISK 

10.6 

X 

X 

BUBBLE  DEVICE 

18.4 

X 

X 

FLOPPY  DISK 

49  .7 

X 

X 

between  the  hard  dlsic  and  floppy  dlsic  were  possible.  The 
results  of  this  test  are  shown  In  Taole  5.4. 

From  these  results,  it  can  be  seen  that  the  multi-user 
CP/li-86  system  has  a  slight  performance  advantage  for  single 
user  disk  operations.  When  more  than  one  user  is  operating 
in  the  system,  this  performance  advantage  becomes  very 


.4 

es  In  Seconds 


EiRD 

DISK 


FLOPPY 

DISK 


ONE  USER  SXECaTiNG  PIP  UNDER  MP/M 


EARD  DISK 
FLOPPY  DISK 


11.2 


12.0 

14.8 


TteO  USERS  EXECUTING  PIP  UNDER  MP/M 


HARD  DISK 
FLOPPY  DISK 


17.4 

26.3 


26.2 


TEREE  USERS  EXECUTING  PIP  UNDER  MP/M 


HARD  DISK 
FLOPPY  DISK 


23.7 

36.9 


Significant  for  transfers  made  between  areas  on  tbe  hard 
disk.  However,  the  RSMEX  floppy  disA  drives  are  slower. 

Since  the  REMSX  hard  disk  can  be  used  to  emulate  the 
"signal  processor"  functions  of  the  AEGIS  system,  a  third 
test  was  conducted  to  determine  the  optimum  Sicew  factor  for 
consecutive  read  operations.  A  low-level  routine  was 
written  to  continuously  read  sectors  from  the  hard  disA  into 
common  memory.  After  each  read  operation,  a  counter  was 
incremented.  When  five  read  operations  had  been  completed,  a 
character  was  printed  to  the  CRT  screen.  The  time  it  tooA 
to  print  80  characters  to  the  CRT  is  recorded  and 


90 


Table  5.5 

REMEX  Winchester  Dish  Skew  Times 
in  Seconds 


SKEW 

TOTAL 

SKEW 

TOTAL 

FACTOR 

TIME 

FACTOR 

TIME 

0 

10.00 

20 

5.25 

1 

10.35 

21 

5.55 

2 

10.55 

22 

5.80 

3 

10.95 

23 

6.10 

4 

11.25 

24 

6.35 

5 

11.45 

25 

6.60 

6 

11.70 

26 

6.85 

7 

11.95 

27 

7.10 

8 

12.20 

28 

7.35 

9 

12.55 

29 

7.55 

10 

12.75 

30 

7.80 

11 

13.05 

31 

6.05 

12 

13.40 

32 

6.30 

13 

13.45 

33 

8.65 

14 

13.70 

34 

8.85 

15 

4.20 

35 

9.20 

16 

4.35 

36 

9.45 

17 

4.55 

37 

9.65 

la 

4.a5 

38 

9.85 

19 

5.05 

approximates 

the  time  it  took 

to  conduct  400 

separate 

operations. 

During  the  first 

run,  the  skew 

factor  was 

to  zero.  Therefore,  no  sectors  were  skipped  between  read 
operations.  In  the  subsequent  runs,  the  skew  factor  was 
Incremented  by  one  for  each  successive  test,  llie  results  are 
shown  in  Table  5.5  and  indicate  that  a  skew  factor  of  15  is 
optimal  for  reading  data  from  the  R£M£X  bard  disk. 


C.  RECOMMENDATIONS  ?0R  FUTURE  WORE 


There  are  several  possible  opportunities  for  future 
projects  involving  the  REMEX  hard  disk  and  the  multi-user 


CP/M>86  system.  The  first  and  foremost  Is  the  use  of  the 
system  to  emulate  the  AEGIS  system.  Several  AEGIS  system 
modules  have  already  been  developed  aud  could  be  run  on 
dedicated  ISBC  86/12A  computers  usln^  the  REMEX  hard  disk  to 
supply  simulated  radar  data.  In  the  present  hardware 
configuration,  four  system  modules  could  be  run  concurrently. 

However,  there  are  other  smaller  support  projects  which 
would  Increase  the  capability  and  utility  of  the  system. 
There  Is  an  urgent  need  for  a  more  sophisticated  text  editor 
or  word  processor.  Without  one,  the  system  will  not  be  used 
to  its  full  capabilities.  Translating  the  8080  assembly 
language  code  of  BTED.COM  into  80b6  assembly  language  would 
provide  a  more  usable  text  editor  than  the  one  currently 
provided  by  Digital  Research  -  ED.CMD. 

Another  possible  project  Is  to  develop  a  boot  loader 
program  for  the  REMEX  Data  Warehouse.  As  the  system  is 
currently  designed,  the  CP/M  operating  system  must  be 
initially  loaded  from  either  the  MBB-80  or  from  the  MDS 
single  density  system.  This  would  allow  CP/M  to  be  booted 
from  any  of  the  memory  storage  devices  currently  in  the 
system. 

A  more  ambitious  project  would  oe  to  design  a  boot 
loader  which  permitted  the  user  to  boot  not  only  the  master 
CP/M-86  operating  system  directly  from  the  REMEX  Data 
Warehouse,  but  the  slave  CP/M-66  operating  system  as  well. 
This  would  relieve  the  master  system  of  the  task  of  loading 
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the  CP/M  slave  system  and  the  boot  loader  proj^ram  into 
common  memory  prior  to  booting  the  other  slave  computers. 
Furthermore,  it  would  free  a  larger  portion  of  common  memory 
for  general  use  and  decrease  the  number  of  system  variables 
that  would  have  to  be  reconstructed  should  common  memory  be 
destroyed.  The  programs  LDCPM.A86,  LDB00T.A36  and  B00T.A86 
which  are  already  written  could  be  combined  to  form  the 
nucleus  for  such  a  program.  Once  operating  correctly,  the 
program  would  have  to  be  loaded  into  an  iSBC  66/12A  EPROM 
where  it  would  be  accessible  to  the  monitor. 

The  final  project  could  alter  the  CP/M-86  BIOS  to 
include  the  Micropolis  Winchester  hard  disk,  the  MDS  double 
density  disk  drive  system,  and  the  newly  acquired  256K 
bubble  memories.  The  code  for  the  Micropolis  hard  disk  and 
the  MDS  double  density  disk  drive  system  has  already  been 
written  and  only  needs  to  be  put  into  the  table-driven  BIOS 
format.  The  Implementation  of  the  new  bubble  memories 


should  be  very  similar  to  that  of  the  MBB-80. 


iiumi  A 
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I.  MBB-e0  BUBBLE  MEMORY  TILES 

A.  MB80TMT.CMD:  This  program  is  used  to  Initially 
format  the  MBB-e0  huhhle  storage  device  as  a  single  density 
disk  drive.  ¥hen  the  program  is  executed  it  vill  prompt  the 
user  for  a  segment  address.  The  address  of  S0fe)0  must  be 
entered.  The  program  will  then  set  the  controller  base 
address  to  8000h  and  write  the  correct  byte  patterns  on  the 
bubble  memory  system  to  give  it  the  appearance  of  a 
diskette.  [Ref.  2  :  p.  86  and  p.  159] 

B.  MBe0ROM.A86:  This  file  contains  the  source  code 
necessary  for  bootstrapping  tae  system  from  tae  bubble 
memory  device.  It  has  been  loaded  into  an  EPROM  and  placed 
on  the  motherboard  of  the  iSCB  e6/12A  computer  labeled  #1. 
It  is  executed  by  entering  the  command  GFPI)4:4  into  the 
monitor  of  the  computer.  The  program  will  then  place  the 
system  loader  into  memory  and  transfer  control  to  it.  [P.ef. 
2  :  p.  1871 

C.  LDRMB80.CMD;  This  is  the  loader  program  that  must 
be  placed  on  the  bubble's  tracks  0  and  1.  It  will  locate 
the  file  CPM.STS  on  the  bubble  memory  device,  load  it  into 
memory  and  then  transfer  control  to  the  operating  system. 
The  BIOS  for  this  program  is  created  using  MBBIOS .A86  with 
the  loader  conditional  assembly  switch  set  to  true. 


D.  M9BI0S.AS6:  This  file  contains  the  source  code 

used  to  create  the  BIOS  for  both  the  CPM.STS  and  the 
LDRnB80.CMD  The  CP/M. STS  BIOS  is  created  vith  the  ^  loader 
conditional  assembly  switch  set  to  false.  [Bef.  2  :  p.  1661 

E.  DEPBM.DEP:  This  file  contains  the  hardware 

configuration  tables  for  arranging  up  to  16  MBB-80  bubble 
memory  devices  or  Intel  MDS  double  density  disic  drive 
systems  in  any  combination.  It  was  -ised  by  Hichlln  and' 
Neufeld  in  their  implementation  of  a  "table  driven”  BIOS. 
However,  different  I/O  devices  (i.e.  HSMEX  Data  Warehouse) 
may  not  be  added  to  their  table.  [Ref.  2  :  p.95] 

P.  CONIIO.DEF:  Contained  in  this  file  are  tne  disk 

definition  statements  used  by  Hicklln  and  Neufield  to 
generate  the  Disk  Definition  Tables  for  their  BIOS.  The 
file  generated  is  labeled  CONFIG. LIB  and  is  included  into 
MBBIOS.AS^  when  assembled.  [Ref.  2  :  p.  92l  and  [Hef.  6  : 
p.  67] 

II.  RSMEX  DATA  WAREHOUSE  FILES 

A.  CPM3I0S.A86;  This  file  is  the  basic  table  driven 
BIOS  used  in  this  thesis.  By  setting  the  MASTER/SLA7E 
conditional  assembly  switch  to  either  true  or  false,  two 
different  CPM.STS'vj  can  be  created.  The  only  difference  in 
the  two  is  that  the  CPMMA3T.CMD  system  contains  code  to 
initialize  the  synchronization  and  login  variables  located 
in  common  memory.  The  resulting  MASTER  file  should  be 
renamed  to  CPM.STS  and  placea  on  the  bubble  memory  storage 


device.  Interln^  the  comand  CrFTD4:4  from  the  iSBC  66/12A 
computer  labeled  #1  will  boot  the  sjstem. 

Whea  the  MASTSR/SLATB  conditional  assembly  switch  is 
set  to  false,  a  slave  system  will  be  created.  This  system 
should  be  named  CPMSLAVS.CMD.  It  is  this  file  that  is 
eventually  loaded  into  common  memory  via  the  command 
LDCPM.CMD. 

After  the  slave  system  has  been  loaded  into  common 
memory,  the  command  LOBOOT.CMD  must  also  be  executed  in 
order  to  place  the  loader  program  into  common  memory.  Once 
these  two  commands  have  been  executed,  all  other  computers 
can  issue  the  command  QE000:400  to  the  computer  monitor  and 
the  CP/M  operating  system  will  be  loaded  for  each. 

B.  CPMMAST.CFG:  This  file  contains  the  label  tables 
for  the  seven  I/O  device-specific  functions  which  are 
extracted  out  of  the  BIOS.  These  functions  are  INIT, 
SBLDSK,  HOME,  SELTRK,  SELSEC,  SETDMA,  and  SSTBMAB.  A 
conditional  assembly  switch  is  located  in  the  INIT  table. 
When  the  master  switch  is  set  to  true,  two  extra  labels  are 
included  which  permit  the  initialization  of  the 
synchronization  and  login  variables  in  common  memory. 

C.  MB80DSK.A86:  Located  in  this  file  is  the  code 
necessary  to  read  and  write  to  the  MBB-60  Bubbl-Board .  It  is 
assembled  into  the  CPMBI0S.A86  file  by  an  "include” 


statememt 


D.  RZFL0P.A86:  This  file  contains  the  code  for 
reading  and  writing  to  the  RRhEZ  Bata  Warehouse's  two  floppy 
disk  drives.  It  is  assembled  into  the  CPM3I0S.A86  file  by 
the  use  of  an  "include"  statement.  Command  packets  for  the 
REMEZ  are  built  in  common  memory  and  all  BMA  is  accomplished 
through  common  memory. 

The  file  labeled  HZFL0P1.A86  is  almost  identical  to 
RZEL0P.A86.  The  difference  Is  that  common  memory  is  not 
used  for  BKA  or  packet  building.  Insteaa  the  9EMEZ  directly 
accesses  the  host's  on  board  memory.  Thus  RZEL0P1.A36  will 
only  work  for  a  computer  which  has  its  local  memory  address 
space  between  00a00h  and  0FEF?h.  To  permit  additional 
computers  to  use  this  code*  the  packet  addresses  built  in 
this  BIOS  will  have  to  be  changed  to  correspond  to  the 
computer's  memory  address  space  within  the  system's 
addressable  memory  space  of  1  Megaoyte. 

E.  RZEARB.A66:  This  file  contains  the  code  necessary 
to  access  the  Kemez  Data  Warehouse's  Winchester  hard  disk. 
It  also  contains  the  blocjcing  and  deblocking  code  required 
for  mapping  the  REMEZ's  512  byte  sectors  to  CP/M's  126  byte 
logical  sectors.  It  Is  assembled  into  the  CPMBI0S.A66  file 
by  an  "include”  statement.  Command  packets  for  the  REMEZ 
are  built  in  common  memory  and  all  DMA  is  accomplished 
through  common  memory  . 

The  file  RZBARD1.A86  is  almost  identical  to  RZEARD.A&6. 
The  difference  being  that  common  memory  is  not  used  for  DMA 


or  pacicet  building.  See  &X7L0P.A66  for  more  detallt  as 
changing  RXEAHD1.A86  to  accomodate  more  than  one  user 
requires  the  same  changes  as  SXXL0P1.A86. 

?.  CPMMAST.DE7:  This  file  contains  the  CP/M-e6  dish 
definition  statments  used  In  this  thesis.  It  Is  the  source 
file  for  GrENDSP.CMI)  which  produces  the  file  CPIiMAST.LIB. 

a,  CPMMAST.LIB:  This  file  Is  assembled  into  the 
CPMBI0S.AS6  via  an  "include"  statement.  It  contains  the  Disk 
Parameter  Tables  created  by  the  CP/M  utility  program 
(jENDEF.CMD,  using  the  file  CPMMAST.DEF  as.  the  Input  file. 

E.  INTELDSK.A86:  While  this  file  Is  not  Included  In 
the  final  hardware  Implementation  of  this  thesis,  It 
contains  the  code  necessary  for  accessing  the  Intel  MDS 
single  density  disk  drive  system.  It  was  used  extensively 
in  the  early  developmental  phases  of  this  thesis  because  It 
provided  an  easy  method  of  booting  a  new  CPM.S7S.  If  this 
file  Is  Included  into  the  CPMBIOS,  the  CP/M-86  operating 
system  can  be  booted  by  issuing  the  command  (j?PD4:0  to  the 
monitor . 

I.  LDCPM.A86;  This  program  must  be  executed  in  order 
to  load  CPMSLAVE.CMD  into  common  memory  beginning  at 
10^0 : 500 . 

J.  LD300T.A86:  This  program  must  be  run  before  the 
slave  CP/M  system  can  be  loaded  by  the  other  computers. 
When  executed,  the  program  BOOT.CMD  will  be  placed  in  common 
memory  beginning  at  E000:400. 


I.  BOOT.CMD:  This  is  the  loader  program  used  by  all 
but  the  Initial  computer  to  boot  the  CFMSLAVE  operating 
system  from  common  memory.  It  Is  executed  by  entering  the 
command  CrE000:4SI0  from  the  monitor  after  the  programs 
LSCPM.CMl)  and  LDBOOT.CMB  have  been  run. 

L.  RZF0HMAT.A86:  Vhen  an  I/O  device  is  first 
Initialized  for  use  under  the  CP/M  operating  system,  the 
hex  code  Z5's  must  be  written  on  the  tracks  which  will 
contain  the  directory,  otherwise  the  error  "NO  DIHECTOET 
space"  will  occur.  This  program  will  write  S5's  on  the 
necessary  tracks  for  each  head  of  the  Winchester  hard  disk. 
Since  executing  this  program  will  erase  all  files  accessible 
to  the  different  heads.  It  will  prompt  the  user  for 
permission  to  precede  in  order  to  Insure  that  tne  files  are 
not  erased  by  mistake.  Normally  this  program  will  not  be  of 
any  use  unless  a  new  hard  disk  is  installed  or  a  directory 
track  is  Inadvertently  destroyed. 

M.  EIMAINT.A66:  The  SEMEI  Bata  Warehouse  contains 
numerous  built-in  error  checking  and  maintenance  programs 
which  can  be  implemented  by  building  and  then  sending 
maintenance  packets  to  the  REMEZ.  This  program  prompts  the 
user  to  choose  one  of  these  built-in  maintenance  programs 
and  then  runs  the  test.  If  an  error  is  encountered,  tne 
error  code  is  printed.  The  meanings  of  the  error  codes  can 
be  found  in  the  REMEZ  technical  manual.  [Ref.  9  :  p.  3-19] 

N.  LCr,lN.A86:  This  file  contains  the  code  necessary  to 


provide  protection  from  more  then  one  user  logging  on  to  the 
seme  eree  of  the  herd  disk  or  the  MBB-82  hoerd  et  the  seme 
time. 

0.  STNC.A66t  This  file  must  be  included  in  the  BIOS 
when  more  then  one  computer  is  going  to  operete  on  the 
Multibus.  It  conteins  the  code  which  prevents  more  then  one 
computer  from  eccessing  shered  resources  While  enother  is 
conducting  a  reed  or  write  operetion  through  common  memory. 
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t?Tog  Mane 

;nodified 

•Sate 

;VritteB  By 
fFor 

;AdTlsor 

f Purpose 
• 


CPNBIOS.iae  (Master/Slave  CPH  Bios) 
Inclusloa  of  Syachroaiiatloa  loatine 
7  October  1982 

Toa  f.  dlntulst  aad  David  S.  Steveas 
Thesis  (IIGIS  nodeliac  Group) 

Professor  Codres 

This  BIOS  is  for  use  with  the  1$B86/12A. 
It  requires  a  separate  iaclnde  file  for 
each  differeat  I/O  device. 


tree 

equ  -1 

false 

eqn  aot  true 

cr 

equ  0dh 

•carriage  retura 

If 

eqa  8ah 

•  liae  feed 

error 

equ  8ffh 

tgeaeral  error  ladicatioa 

Raster 

equ  true 

;set  for  aaster/slave  BIOS 

tsystea  addresses 

bdos.iat 

equ  224 

•reserved  BDOS  interrupt 

ccp_offset 

equ  0209h 

•  start  of  CCP  code 

bdos. offset 

equ  BB06h 

•BDOS  eatry  point 

bios. offset 

equ  2S0Gh 

•start  of  BIOS  code 

;coasole  via 

the  18251  U3A1T 

cstat 

equ  8dah 

•status  port 

cdata 

equ  Bd8h 

•data  port 

the  ask 

equ  1 

•transnit  buffer  empty 

rdansk 

equ  2 

; receive  data  available 

cseg 

OTft 

ccpoffset 

ccp : 

org 

blos.of  fset 

;  m**m**9^**** 

bios: 

;JUMP  rscTORS 

jnp  IB  IT  ;Bater  fron  BOOT  iOn  or  L0A2SS 


Jmp  VEOOT 
jmp  CONST 
jmp  GONIN 
jmp  CCNOUT 
jmp  LISTOOT 
jmp  PUNCH 
jmp  HliUEl 
jmp  HOME 
Jmp  5IIDSK 
jmp  SSTTIC 
jmp  SETS EC 
jmp  SETUMA 
Jmp  READ 
jmp  WRITE 
jmp  LISTST 
jmp  SECTRAN 
jmp  SETDMAB 
jmp  GETS SOT 
jmp  GETI03F 
Jmp  SETIOBP 


{Arrive  here  from  BDOS  call  0 
{return  console  keTBoard  status 
{return  console  her board  char 
. {write  char  to  console  device 
{write  character  to  list  device 
{write  character  to  punch  device 
{return  char  from  reader  device 
{move  to  trk  00  on  sel  drive 
{select  disk  for  next  rd/wrlte 
{set  track  for  next  rd/wrlte 
{set  sector  for  next  rd/wrlte 
{set  offset  for  user  buff  (DMA) 
{read  a  128  byte  sector 
{write  a  126  byte  sector 
{return  list  status 
{xlate  lo^lcal->physical  sector 
{set  seg  base  for  buff  (DMA) 
{return  offset  of  Mem  Desc  Table 
{return  I/O  map  byte  (iobyte) 
{set  I/O  map  byte  (iobyte) 


Entry  Point  Routines 


include  login. a66  {necessary  for  multi-users 


INIT:  {print  signon  message  and  initialize  hardware 


{and 

software 

mov 

ax,  cs 

{we  entered  with  a  JMPF 

mov 

ss.ax 

{so  use  cs:  as  initial 

mov 

ds,az 

{segment  values 

mov 

es,az 

mov 

sp, offset  stkbase 

{use  local  stack 

mov 

iobyte, 0 

{clear  iobyte 

push 

ds 

push 

es 

cld 

{set  interrupt  0  vector  to 

mov 

az,0 

{  address  trap  routine 

mov 

ds,az 

mov 

es,az 

mov 

iat0_off St .offset 

int  .trap 

mov 

into  segment, cs 

mov 

di,4"  ; 

propagate  to  remaining  vectors 

mov 

si,0 

mov 

cz ,510 

movs 

ax, ax 

mov 

bdio,bdos_offset 

{correct  bdos  int  vector 

pop 

es 

{correct  bdos  int  vector 


pop  ds 
call  con.init 
zor  bZfbx 


; initialize  console 
;^et  mass  storage 


inil : 


nov 

aZfintbl  [bz] 

( initlization  table 

or 

aztaz 

fQuit  if  end  of  table 

J2 

ini2 

push 

bz 

call 

az 

;call  init  entry 

pop 

bz 

inc 

bz 

tstep  to  next  entry 

inc 

bz 

Jmp 

inil 

;ioop  for  next 

ini2: 

call 

login 

mov 

bzyoffset  signon 

fprint  sign  on  msg 

call 

pmsg 

mov 

cl .user 

•default  to  a:  on  coldstart 

Jnp 

•  - 

ccp 

•Jump  to  cold  entry  of  CCP 

VBCOT:  ; enter  CCF  at  command  level 


Jmp 

ccp+6 

CONST : 

•return  console  status 

in 

al .cstat 

and 

al .  rdamsic 

Jz 

coni 

or 

al,0ffh  treturn  non-zero  if  rda 

coni:  ret 


CONIN  : 

•  get  a 

character  from  console 

call 

CONST 

Jz 

in 

CONIN 
al , cdata 

•wait  for  3LA 

and 
r  et 

al,7fh 

•read  data  &  remove  parity  bit 

CONCUT; 

•send  a 

character  to  console 

in  al,cstat 
and  al.tbemsk 


iget  console  status 


;znlt  buff  is  empty 
tthen  return  data 


jz  CONOUT 
mov  alfCl 
out  cdata,al 
ret 


LISTOUT:  t send  character  to  list  device 

;not  yet  implemented 


ret 


PUNCH:  iwrite  cnaracter  to  punch  device 

fuot  implemented 


ret 


HEADER 


HOME: 


SELDSK 


tfret  character  from  reader  device 
;not  implemented 


mov 

ret 

al , lah 

Jreturn  eof 

;move  selected 

disk  to  trz  00 

one  of  seven 

device  specific  functions 

mov 

tracic,0 

xor 

bz,bx 

mov 

bl tunit 

?get  offset  to  actual 

de vie  e 

add 

bz,  bz 

call 

hmtbl  [bz] 

Jcall'  device  code  via 

tables 

ret 

;one  of  seven  device  specific  functions 
Jreturn  pointer  to  appropriate  'disA 
;parameter  block'  (zero  for  bad  unit  no) 
;notE:  nunits  is  defined  in  tne  .cfg  file 


mov 

uni t,cl 

jsave  unit  number 

mov 

bx,0000h 

»ready  for  error 

return 

emp 

cltuunits 

ireturn  if  beyond 

max 

uni  t 

Jnb 

sell 

mov 

bl , unit 

Jget  offset  to  actual 

device 

add 

bz,  bz 

call 

dsktbl  [bz] 

{call  device  code 

via 

tables 

xor 

bz,  bz 

104 


mov 

bl  ,UBlt 

Jbz  -  cl  ♦  16 

mov 

cl  ,4 

shl 

bz,cl 

mov 

cz,  offset  dpbase 

fbz  &dpbase 

add 

bz,cz 

tset  track  addrtss 

oae  of  seven  device  specific  functions 


mov  track, cl 
zor  bz,bz 
mov  blfUnlt 
add  l)z,1)z 
call  trktblEbz] 
ret 


Jget  offset  to  device 
tcall  device  code  via  tables 


SETSEC : 


iset  sector  number 

one  of  seven  device  specific  functions 


mov  sector, CL 
zor  bz,bz 
mov  bl,unlt 
add  bz.bz 
call  sectblCbz] 
ret 


(get  offset  to  device 
(Call  device  code  via  tables 


WRITE:  »vrite  from  dma  address  to  selected 
lunlt,  track,  sector 


xor  bx,bz 
moT  bltunit 
add  bx.bx 
call  vrtblLbx] 
ret 


»call  derice  code  via  tables 


LISTST: 


;poll  list  device  status 
;not  Implemeated 


or  al,0ffh 
ret 


; return  ready  anyway  or 
; system  may  bang  up 


SECTRAN: 


; translate  sector  cx  by  table  at  Ldz] 
fNOTS:  this  routine  is  not  adequate  for 
» the  case  of  >»  256  sectors  per  track 
rStill  it's  better  than  DR's  which  is  not 
iadequate  for  the  no  table  case  either 


SETDMAB : 


mov 

ch,3 

mov 

bx,cx 

cmp 

dx,0 

{check  for  no  table  case 

Je 

sel 

add 

bx,dx 

{add  sector  to  table  addr 

mov 

bl ,  [bx] 

{get  logical  sector 

ret 

"{set  DMA 

segment  given  by  ci 

mov 

dma_seg,cx 

GETSEGT: 


{return  addr  of  physical  memory  table 


mov  bx, offset  segtable 
ret 


GET  I OB F: 


{return  lobyte  value 

{note  -  this  function  and  SETICEF 


136 


tare  OC  but  to  implement  the  function 
t the  character  10  entrx  point  routines 
{must  he  modified  to  redirect  10 
{depending  on  the  value  of  lobyte 


mov  al, lobyte 
ret 


SETIOBF: 


fSet  lobyte  value 


mov  lobyte, cl 
ret 


;  SUBEOUTI NES 


int_trap; 


{interrupt  trap  -  non  interrupt 
{driven  system  so  should  never  get 
{here  -  send  mesage  and  halt 


cli 

{block  interrupts 

mov 

az,cs 

mov 

ds,ax 

{get  our  data  segment 

mov 

bx, offset  int_trp 

call 

pmsg 

hit 

{ hardstop 

con  inlt: 


{initialize  console  driver 

{actually  done  by  the  lS3CS6/12a  monitor 


ret 


• 

9  .  ii_  -  - 

pmsg; 

{send  a  message 

to  the  console 

mov 

al ,  [bx] 

{get  next  char  from 

message 

t  - 

test 

al  ,al 

jz 

pmsl 

{if  zero  return 

mov 

cl  ,al 

call 

CONOUT 

{print  it 

Inc 

bx 

4 

Jmps 

pmsg 

{next  character  and 

loop 

It;? 


DISK  SPECIFIC  FUNCTION  LABEL  TABLES 


;The  included  .cfg  file  below  maps  unit  number  to  dislc 
Jdevice  type.  It  provides  tables  of  entry  point 
iaddresses  for  use  by  init.  seldsk,  seltrk  selsec,  home. 
;read  and  write.  These  addresses  must  appear  in  the 
.appropriate  include  file  for  the  particular  device  type 

include  cpmmast .cfg  ; read  in  label  tables 


4c4t«.gi](c4i4E«<c.(i4i«4i«igi  14141  4c 

DISK  INCLUDE  FILES 

4i4i)tc4(4c4i4i4c4i4>4c4c4c4c4c4c4(4c4c4(4c4c4c4c4c4c4c4i4c4c4c4c»4c4c  4c4c)e(4c4c«agt«4c4c4c4>4(4c4c4c4c4c«4c4i4c4c4c 


.For  each  I/O  device  to  be  accessed  by  the  operating 
;system  a  separate  file  must  be  included.  Within  each  file 
.seven  functions  must  be  addressed  and  are  the  same  ones 
.mentioned  in  CPI^MAST  .CFO .  The  labels  used  to  access  these 
.functions  must  be  properly  order  in  CPMMAST, CFS, 


include  mb60dslc.a66 
include  rxflop.a86 
include  rxhard.a86 


;MBB-6i>  bubble  memory 
.•HEMEX  flopyy  disks 
JREMEX  hard  disk 


4(4c4c4i4c4c4(4(4c4(4c4t4c4c4(4i4E4c4c««4c4c4c4(4c4cXc4c4e4c4c4(4e4(3Cc4c4c4c4c4c4c)«i4‘4e4c4c4C4c4c4i4(4c)Cc4c«4(4c# 

RESOURCE  ALLOCATION 

4c4E4i4i4c4[4(4c4i4c4c4c4c4c«4c4c4c4(4c4c#4c4(4>4c«4c4c4c4i4c4c4c4c4c4c4>>tc4c4:4c4c4c4c4C4c)t(a;cXC4c4C9;(4c4c4(4c4c4c 


»Lov-level  synchronization  of  access  to  the  shared 
;devlce.  <sync.a86'>  must  include  the  entry 
.points  defined  in  the  cfg. files.  These  are 
.called  on  initialization  and  before  and  after 
♦accessing  the  resource  respectively. 

Include  sync  .a66 


DATA  &  LOCAL  STACK  AREA 


cseg  $ 

signon  db  cr,lf,cr,lf 

db  cr.lf.lf,' 

if  master 


db  'CPM/66  Master  ' 

endif 

if  not  master 

db  'CPM/86  Slave' 

endif 

db  or, If, If.'  Modified  ' 

db  '  6  October  1982  by' 

db  cr.lf.lf,'  Tom  T.  Almqulst' 

db  '  and  David  S.  Stevens', cr, If , If 

db  '  Por  use  with  a  Bubble  Memory  and  ' 

db  'the  RSMEI  Dataware  House' 

db  cr,lf,0 

int_trp  db  cr.lf 

db  'Interrupt  Trap  Halt' 

db  cr,lf,£ 

iobyte  rb  1  icharacter  l/o  redirection  byte 

unit  rb  1  ^selected  unit 

trade  rb  1  ?selected  trade 

sector  rb  1  Jselected  sector 

dma_adr  rw  1  -selected  DMA  address 

dma_seg  rw  1  Jselected  DMA  se^rment 

loc_stlc  rw  32  ilocal  stadc  for  initialization 

stiebase  eou  offset  $ 

{system  memory  segment  table 

segtable  ib  1 

dw  tpa_seg 
dw  tpa  len 
dw  2000E 
dw  2000H 

DISK  DEFINITION  TABLES 

{The  included  .lib  file  contains  disk  definition 
{tables  detailing  dish  characteristics  for  the  bdos 
{.lib  files  are  generated  by  OENDEF  from  definition 
{files  and  must  comply  with  the  allocations  made  in 
{the  corresponding  configuration  file.  (Lable  Tables) 

include  cpmmast.lib  {read  in  dish  lef  tables 


•  ]ti4i4c)«i4i4c4cjtt4>>9(4i««««4t>9<4(a0(>|i«4<#«>gE4i4»0c>O4i4»9(>9(4(4t)9»t(4i«K(i9t«»>tt)Cc«>«^>«‘>9i>:()«(>::4t4ES»9c>it>9t 

{  END  OF  BIOS 

•  4c4i4t4i4iat»(i4t4i4(4»(M«»t»((4iK(««««»>9t>g(«4(>»«iO>4i)t»9"9»«»9(>i»9t«4i4tSC)9"9>i(<4t>9t«>9i4(>9»tc>t>:;‘«>9>4»9"9(>9t 

lastoff  equ  offset  $ 

tpa_seg  equ  (lastoff +0400h-^15 )  /  16 

tpa_len  equ  1000h  -  tpa,seg 


{1  segment 

{1st  seg  starts  after  BIOS 
{and  extends  to  top  of  TPA 
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;  PAGE  ZERO  TEHPLATE 

J^^^HlC**>tl3)C******#**»l*n‘****tlt0^******************************** 

dseg  3  ;absolute  low  memory 

org  0  ; (interrupt  vectors) 

iatO.offst  rw  1 

int0  segment  rw  1 

rw  2*(bdos_int-l) 

bdio  rw  1  ;bdos  interrupt  offset 

bdis  rw  1  Ibdos  interrupt  segment 


iProg  Name 
iCate 

IWritien  by 
fPor 

fAdvisor 
;  Purpose 


APPINDJX  C 

PROGBAM  LISTING  Of  CPMMAST.CPG 


CPMflAST.CFG  (  Master  Configuration  for  CPM } 

13  September  1962 

Ton  T.  Almqulst  and  David  S.  Stevens 
Thesis  (AEGIS  Modeling  Group) 

Professor  Kodres 

This  code  Is  an  include  file  v/ln  CPMBI0S.A86, 
It  contains  the  device  tables  for  access  to 
Initialization*  read*  &  vrite  routines. 


;  DEFINE  nunits 

nunits  db  7  ; total  number  of  mass  storage  units 


INITIALIZATION  TABLE 


intbl  contains  a  sequence  of  addresses  of  Initialization 
entry  points  to  be  called  by  the  BIOS  on  entry  after 
a  cold  boot.  The  sequence  is  terminated  by  a  zero  entry 

ntbl  dw  offset  mbSOdsk  init  » Initialize  Bubble 


dw  offset  rxflop.init 
if  master 

dw  offset  Initsync 
dw  offset  init  login 

endlf 

dw  d 


iinitialize  Remex 

finitialize  sync  variables 
ilnltialize  login 
;  procedures 
fend  of  table 


;  READ  TABLE 

trdtbl  and  wrtbl  are  sequences  of  length  nunits,  containing 
;the  addresses  of  the  read  and  write  entry  point  routines 
jrespecti vely  which  apply  to  the  unit  number  corresponding 
;to  the  position  In  the  sequence.  These  and  the  entry  pts 
Jfor  Initialization  must  correspond  to  those  contained  in 
; the  appropriate  Include  files  containing  code  specific 
;to  the  devices. 


dw  offset  mb80dsiE_read 
dw  offset  rxflop_read 
dw  offset  rxflop_read 


il:  is  a  bubble  memory 
>3:  is  Remex  floppy  disk  1 
;C;  is  Remex  floppy  disg  2 


dv  offset  rzhard.read 
dv  offset  rzhard.read 
dv  offset  rxhard.read 
dv  offset  rzliard.read 


;]}:  Is  Remez  hard  disir  0 
>5:  is  R«nez  hard  dish  1 
is  Remez  hard  disk  2 
;G  is  Remez  hard  disk  3 


;  WRITS  TABLE 

vrthi  dv  offset  mh80ds<_vrite 
dv  offset  rzflop.vrite 
dv  offset  rzflopivrite 
dv  offset  rzhard_vriie 
dv  offset  rzhard_vrite 
dv  offset  rzhard^vrlie 
dv  offset  rzhard  vrite 


hmtbl 


dv  offset 
dv  offset 
dv  offset 
dw  offset 
dv  offset 
dw  offset 
dv  offset 


HOME  TABLE 

mb80dsk_home 
rzf lop_horoe 
rzf  lop_hoine 
rzhardihome 
rzhard. home 
rxhardlhome 
rzhard'home 


;  SELDSK  TABLE 

dskthl  dv  offset  mb80dsz_seldsk 
dv  offset  rzf lop.seldsk 
dw  offset  rzf lop’seldsk 
dw  offset  rzhard.seldsk 
dw  offset  rzhard_seldsk 
dv  offset  rzhard.seldsk 
dv  offset  rzhard  seldsk 


SET THE  TABLE 


trktbl  dw  offset  mbendsz.seitrk 
dw  offset  rzf lop.settrk 
dw  offset  rzf lop.settrk 
dw  offset  rxhard.settrk 
dw  offset  rzhard^settrk 
dw  offset  rzhard. settrk 
dw  offset  rzhard  settrk 


112 


;  SITSEC  TABLE 

sect))l  dv  offset  mbSedslc.setsec 
dv  offset  rzflop.setsec 
dw  offset  rzflop.setsec 
dv  offset  rzhard.setsec 
dv  offset  rzhard.setsec 
dv  offset  rzhard.setsec 
dv  offset  rzhard^setsec 


APPENOII  D 

PS06BAM  LISTING  Of  MB80DSK.AS6 


fProg  Name 
fCate 

; Modi  fled  Dy 
JPor 

JAdvlsor 

•Purpose 


MB80DSEAe6  (BUBBLE  MEMOIT  DISE) 

24  Aug  1962 

Tom  T.  Almquist  and  David  S.  Stevens 
Thesis  (AEGIS  Modeling  Group) 

Professor  Eodres 

This  code  is  an  include  file  v/in  CPMBI0S.A86 
It  contains  the  code  necessary  to  access  the 
hubhle  memory  as  a  disic  drive. 


; +++++«f++4-++-*-+"f-f-*-+T+++++  EQUATES  +"♦••«■+++++■♦•+++■♦•+++▼+▼++++++•♦•+ 


Miscellaneous  equates  - 


mb_contbase 
addr_hlgh_ram 
bdos_lnt_ type 
sector  slae 


equ  8000H 
equ  0f00E 
equ  224 
equ  128 


•controller  base 
•high  para  user  avail  RAM 
•reserved  BDOS  interrupt 
»CP/M  logical  dsh  sector  size 


• - Magnetic  bubble  characteristics  (MBB-83) 


mb_buflen  equ  144 

mbimaxdevs  equ  7 

mb^maxpages  equ  641 

mb~maxsectors  equ  80 

mb^pages.sec  equ  3 

mb'pagesize  equ  18 

mb_skew  equ  12 


•buffer  length  for  MBB  sector 
•bubble  devices  are  #0-#7 
•#  of  pages  on  each  device 
»#  of  log.  sectors  on  each  dev 
*#  of  pages  per  logical  sector 
•bubble  device  page  size 
•  sicew  factor  for  page  xlation 


I - Magnetic  bubble  command  bytes  and  masAs  (MB3-80^ - 


iiib_chjcbusy_cmd 

mb2chicint_masic 

mb~inhintlcmd 

irb_  lnit_cmd 

mb_mpage_c.'nd 

mb_read_cmd 

mb~reset_cmd 

mbiwritelcmd 

• 

CSEG  $ 


equ  020E 
equ  08 0E 
equ  080E 
equ  01E 
equ  010H 
equ  012H 
equ  040E 
equ  014H 


;is  controller  busy  ?  status 

•  mash  to  chic  for  MBB  interupt 
;interrupt  inhibi t /reset  mask 
•initialize  the  controller 
•multi-page  mode  operation  cmd 

•  multi-page  read  command 
•reset  the  controller 
•multi-page  write  command 
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0 


m 


; ++- 


>*♦ 

mici  spECiric  accuss  cod2 

>  1- +•■♦•+ •*■+■♦«+++■♦•♦ -I 


■*-**•*■•*■*■■*•*•¥•¥•*■ 


finitlalize  bubMe 


fCalled  from  INIT 
tparm  la  -*  none 
;parm  out  -  none 


mb80dsk_lnit: 

”pu5h  es 
lnit_mbb60: 

mov  axtinb.contbase 
mov  es.ax 
mov  ax,mb_maipages 
mov  es:mbp_loopsl2e_lo,al 
mov  es:mbp_loopsi ze_hl ,AE 
mov  es:mbplpgsl2e_reg,mb_ page size 


•controller  base 
•address  to  es  reg 
•pgs  per  bubble  dev 


•Issue  reset  command  to  the  controller 


mov  al ,mb_reset_cmd  »reset 

mov  es:mbp_cmnd_reg,al  ;issue 

•initialize  each  bubble  device 


mask  byte 
reset  cmd 


push 

mov 

mov 

For.each: 

mov 

mov 

push 

call 

pop 

iac 

loop 

pop 

pop 

Device_re 

ret 


cx 

cx,mb  maxdevs^-l 
al,0  ■ 


•save  cx»  outer  counter 
•count  for  loop-#  of  devs 
•device  #  to  initialize 


es:mbp_seleot..bub,al  >select  each  device 
es:mbp_cmnd_reg,mb_lcit_cmd  Jinit  device 


azipush  cxipush  es 

mbbee.walt 

est  pop  cz!  pop  ax 

al 

f or_each 
cz 
es 
t : 


•save  bub#, counter ,es 
Jwait  for  controller 
•reset  es, enter 
•next  device  number 
•dec  cz,  loop  not  zero 
•reset  cx,  outer  enter 
•restore  register 


JHOME  BUBBLE 

mb60dsk_home: 
xor  cx,cx 
call  Settrk 
ret 


•called  via  home  table 


•set  track  to  zero 
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Uelect  bubble  disk 


K-- 


F.-. 


r. 


« 


i 


mb80dsk_seldsic: 

ret 


fcalled  Tla  seldsic  table 
fiio  special  action  required 


SELECT  BUBBLE  TRACK 

mbfiUdsJc.set  trk: 

call  mbb80_track_xlat 
ret 

(Called  via 

seltrk 

table 

SET  BUBLE  SECTOR 

(Called  via 

setsec 

table 

mb8edsk.setsec: 

ret 

(Uo  special 

action 

required 

MBB80_R£A1}  called  via  read 

table 

; reads  a  sector  fronj  bubble 
tparm  in  -  none 

;parm  out  -  status  of  the  op  in  al. 
»  00*  OK,  FJ*  unsuccessful 


mbSOdsk.read 
call 
push 
call 
raov 
mov 
mo  V 
mov 
mo  V 
mov 


• 

request  ;get  resource  (STNC.A86) 

es  Jsave  register 

mbb80_sector_xlat  icompute  1st  page#  of  sect 

ax,mb”contbase  Jaddr  of  controller  base 

es,ax~  ;ioad  es  to  address  bubble 

es;mbp_cmnd_reg,mb_mpage_cmd  Jmultlpage  cmd 
ax,mb_page_no  ; current  page  number 

es:mbp_pagesel_lo ,al  ;page  select  lo  byte 
es;mbp_pagesel3hi,AH  ;page  select  hi  byte 


Jset  number  of  pages  to  transfer  =  pages/sector 


mov  es;mbp_pagecnt_lo,mb_pages_sec  ;#pages  xfer 
mov  es;mop~pagecntlhi,0  Thi  oyte  of  #  Is  3 

;set  up  dma  address  to  receive  data 


mov  cx,mb_buflen 
push  ds 

mov  ax,dma_seg 
push  ax 


;count  for  loop-buffer  size 
;5ave  C?/M's  ds 
;get  dma  segment 
’save  dma  segment  Is 
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4 


,8ii«il  Siiil 


.1 


mov  toz.dma.adr 


;offset  of  dffla  area 


; select  bubble  device  and  issue  read  command 
mov  al, mb_bub.no  ; current  bubble  number 

pop  ds  ~  f local*  readdr  dma  area 

mov  es:mbp_select_bub*al  tselect  current  dev  # 
mov  es:mbp~cmnd_regtmb_read_cmd  ;read  from  FIFO 


Read.int: 

"mov  al,es:mbp_int_flag  *<fet  interrupt  status 
and  al (mb.chKint.masic  tinterrupt  set  ? 

Jz  Read.int  ;if  zero,  keep  checking 


*read  enough  from  bubble  sector  to  fill  dma  area? 

cmp  cx, (mb_buf len  -  sector.size)  ixfer  enough? 

Jnz  Read_one  iif  not,  read  another  byte 

pop  ds  ~  Jrestore  CP/M's  ds 

mov  bx, offset  mb_overflow  Jreset  dest  to  ovrflow 


Jread  from  MBB  FIFO  buffer  into  dma  area 


Readone: 

"mov  al ,  es:mbp_rdata_ri 
mov  [bx3,al 
inc  bx 
loop  Read.int 
push  es 

call  Mbbee.Wait 
pop  es 

mov  es:mbp_cmnd_re<;,m 
mov  al,0 
push  ax 
call  release 
pop  ax 
pop  es 
ret 


;read  a  byte  into  accam 
*load  accum  into  dma  area 
;increment  index 
;dec  cx,  loop  if  not  zero 
;save  es  for  call 
Jwait  for  controller 
;restore  es  after  call 
lnhint_cmd  Jclear  int 
{indicate  no  error 
{save  status  of  read 
{free  resource  (3TNC.A66) 
{restore  registers 


{MBBe0_WRITE  called  via  write  table 

{writes  a  sector  to  bubble 
{parm  in  -  none 

{parm  out  -  status  of  the  op  in  al 
{00  a  OK,  F7  =  unsuccessful 


trbe0dsx_write: 

"mov  al,0 
cmp  al,user 
Jnz  mbwrt_err 
call  request 
push  es 


{bubble  lo#rlcal  drive 
{is  user  lo^rged  in  on  mb80 

{get  resource  (STNC.AcG^ 
{save  register 
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call  Mbb80_Sector_Xlat  ;get  1st  page#  of  sector 
mov  az,mb'contbase  Jaddress  of  controller  base 
mov  es,ax  tload  es  to  address  bubble 

tnov  es:mbp_cmnd_reg,mb_mpage.cmd;multpg  mode  cmd 
moT  az, mb_page.no  {current  page  number 

mov  es:nibp_pagesel_lo,al  {page  select  lo  byte 

mov  es:mbp~pageselIlii«AH  {page  select  hi  byte 

{set  number  of  pages  to  transfer  «  pages/sector 

mov  es:mbp_pagecnt_lo,mb_pages_sec  {#pages  to  zfer 


mov 

es:mbp_pagecnt_hi,0 

{hi  byte  of  #  is  zero 

{ set 

up  dma  address  for 

transfer 

mov 

cx,mb_buf lea-1 

{count  for  loop-write 

push 

ds 

{save  CP/M's  ds 

mov 

az.dma.seg 

{get  dma  segment 

push 

ax 

{save  dma  segment  ds 

mov 

bz,dma_adr 

{address  of  dma  area 

{select  bubble  device  and  issue  write  cmd 

mov 

al,m4)  bub  no 

{current  bubble  number 

mov 

es:mbp  select_bub ,al  {select  current  dev  # 

pop 

ds 

{readdr  dma  area 

mov 

al, [bxl 

{load  first  byte 

mov 

es:mbp_wdata_reg,al 

{write  byte  to  MBB  buff 

inc 

bz 

{increment  index 

mov 

es:mbp.cmnd_reg,mb_ 

write_cmd{ send  write  to  MBB 

{wait  for  interrupt  from 

controller 

!_  int 
mov 

• 

• 

al ,es;mbp_int_flag 

{get  interrupt  status 

and 

al  .mb.chjcint.maslc 

{interrupt  set  ? 

Jz 

Wri  te^int 

{if  zero,  iceep  checking 

{write  into  MBB  FIFO  buffer  from  dma  area 


mov  al.Cbx]  {byte  from  dna  to  al 

mov  es;mbp_wdata_reg,al  {write  byte  to  MBB  buff 

inc  bz  {increment  index 

loop  Write.int  {dec  cx,  loop  if  not  zero 

pop  ds  {restore  CP/M's  ds 

push  es  {save  es  for  call 

call  Mbb80_Walt  {wait  for  controller 

pop  es  {restore  es  after  call 

mov  es:mbp_cmnd_reg,mb_inhint_cmd{ clear  contint 

mov  al,0  {return  success  code 

push  ax  {save  success  code 

call  release  {free  resource  (STNC.AS6) 


trestore  register 


pop  az 
pop  es 
Jnp  mbwrt.ret 
mbwrt_errz 

moT  bz« offset ■ mbvrt^msg 
call  pnsg 

WOT  al.iffh  terror  returned  to  CP/K 

■bvrt.ret: 
ret 


3U33LE  S0B30CTINES 


rl>+++++-f+  +  + -!•+++++  + 


;M3380_SBCTOR_XLAT  called  from:  Mbb80„Read,  Mbb80_¥rite. 

(Computes  1st  page#  for  a  given  sector 
tOQ  a  single  chip.  Based  on  80  sectors 
;on  each  chip  -  sector  =  128  bytes, 
tparm  in  -  none,  works  on  sector 
tparm  out  -  none,  updates  mb_page_no 


Mbb80_Sec tor_Xlat: 

zor  az,az 

xor  cz,ci 

mov  CL, sector 

zor  DX,DX 

mov  DL,mb  sector 

add  cx,DX‘ 

dec  CL 

Jz  Mbb80_sz_exit 
Add_skev: 

add  az, mb. skew 
clc 

sbb  ax,mb_maxpages 
Jae  Dec.sictor 
add  ax,mb.mazpages 
Dec.sector: 

loop  Add.skew 
Mbbe0_  sx_ezitT 

mov"  mb_page_no ,ax 
ret 


fset  ax  to  0  to  bold  page# 
(Clear  cx  for  counter 
;ctr  for  translation  loop 
(Clear  LX 

(Sect#  for  Ist  sect  on  trk 
(add  1st  sect#  to  log  sect# 
(Subtract  1  for  the  loop 
(Sect  1  is  page  0,  no  zlat 

(add  skew  between  pages 
(Clear  carry 
(mod  to  #  of  pages 
(jump  If  positive  (CF=0) 
(Went  (-),  add  back  #pages 

(dec  sector#, add  skew  again 

(Store  page  number 


MBB60_TRACK_XLAT  called  from;  SITTRX. 

(Computes  bubble  #  from  track  #.  Gets 
(first  bubble  sector  (l-Sfi)  for  that 
(track  for  later  conversion  to  page 
(Parm  in  -  none,  works  on  track. 

( prm  out  -  loads  mb.bub_no  ,mb_sector 


Mbb60.Tpaclc_Ilat: 

zor  bz,bz  tclear  bz  for  add 

mov  SL, track  ;ioad  track  ~  index 

add  BL»BL  tdouble  track#  for  index 

mov  ax,mb_track_table [bx]  iget  word  from  table 
may  mb_bub_no,Afl  »low  byte  »  bubb  device# 

mov  mb”sector,al  inigh  byte  »  1st  sector# 

ret 


;mBB80  wait  called  from:  Mbb60  Init,  Mbb80  Read, 

;Mbb80_Write. 

ichecks  status  of  MBB  cont  for  bus/ 
tkeeps  checking  (wait)  until  not  busy 
iparm  in  -  none 
;parm  out  -  none 


Mbb80_Wait: 

mov  ax«mb_contbase  iaddress  of  cont  base 

mov  es*ax  >load  es  to  addr  bubble 

See_2ero : 

mov  al,es:mbp_status_reg  ;get  status  register 
and  al  ,mb_chkbusy_cmd  ;  irs  it  all  zeros  ? 

Jz  See_zero  >if  so,  keep  checking 

Cont_busy: 

~mov  al ,es:mbp_status_reg  ;get  status  register 
and  al ,mb_chgbusy_cmd  >see  if  busy,  and  to  mask 
Jnz  'Cont_busy  »lf  busy,  check  again 

ret 


++  +  +  • 


DATA  SEGMENT  AREA 

■-++-r+++++  +  -r+-r— f +  +  T++-r  +++++-r+^+-  +++-4-4-  + 


9 

irbwrt  msg 

db 

db 

mb_bub_no 

rb 

mb_overflow 

rb 

mb_page_no 

rw 

mb  sector 

rb 

Bubble  Tarlaoles - 

cr, If, 'Write  Access  Not  Permlted' 

'  On  This  Drive. ',0 
1  tbubble  device  number  2-7 

(Mb_buflen  -  sector_slze)  jread  overflw 
1  ;bubble  page’number 

1  ; bubble  sector  number  (1-82) 


JEach  entry  in  the  track  table  corresponds  to  one  of  the 
>24  tracks  on  the  M3B-80.  The  1st  byte  in  each  entry  is  the 
Jbubble  number;  the  2nd  byte  in  each  entry  is  the  starting 
>sector  number  for  that  track  on  that  bubble  device. 
mb_track_table  dw  2000H, 201aH, 20343, 21  </0H  ,  211aH  ,2134H 
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dv  a200E . 021aH , 0234H , 0300H » 031afi . 0334E 
dv  0400E,041aE,0434E,0500E,031aE,0534E 
dv  0600E ,061aE ,0634E, 0700E , 071aE ,0734E 

esEG 

f 

jcbp_pa«esel_lo  rb  1  *ls  byte  for  page  select,  (0) 

mbp_pagesel_hi  rb  1  »ms  2  bits  for  page  select,  (1) 

mbp]]cnind_rei  rb  1  ;command  register,  (2) 

mbp_rdata_reg  rb  1  ;read  data  register,  (3) 

nibplvdata_reg  rb  1  »vrlte  data  register,  (4) 

njbp~statui_reg  rb  1  ;status  register,  (5) 

mbp_pagecnt_lo  rb  1  Jls  byte  for  page  counter,  (6) 

wbp_pagecnt_hi  rb  1  ;ms  2  bits  for  page  counter,  ( 

mbp_loops ize_lo  rb  1  Jls  byte  for  minor  loop  size,( 

iiibp_loopsize_hl  rb  1  Jms  2  bits  for  min  xoop  size,( 

rv  1  ;internal  use(page  pos),  {A,B) 

mbp_pgslze_reg  rb  1  »page  size  register,  (C) 

rw  1  ;TI  use  only,  (D,E) 

mbp_select_bub  rb  1  »two  uses:  select  bubble  dev  iJ) 

mbp_lnt_flag  equ  nbp_select_bub  ;interrupt  flag  (7) 


fl>  -0 


AfP£NDI2  S 

PROGRAM  LISTING  OP  RIPLOP.A86 


Prof  Name 
Date 

Written  by 
For 

Advisor 

Purpose 


RXPL0P.A86  (aEMEZ  FLOPPY  DISK 

ACCESS  CODE) 

9  October  1982 

Tom  Y.  Almquist  and  David  S.  Stevens 
Thesis  (AEGIS  Modeling  Group) 

Professor  Eodres 

This  code  is  an  include  file  w/in  CPMBI0S.A86 
It  contains  the  code  necessary  to  access  the 
Remex  floppy  disk  drives.  I/O  done  through 
common  memory.  This  configuration  is  set  for 
CP/M  logical  drives  1  (B:)  and  2  (C;).  To 
alter,  change  code  in  READ  and  WRITE  routines 


++ -♦■++++•♦•- 


■++■►  Equates 


+ -f -f  + -f  -f  + -r -f -f  4* -f -f  -► -f -f  +  + -f  * -f  + 


I 


-  Disk  Controller  command  bytes  and  masks  (RSMEX) 


dk_rdy_ftiask 

dk3rd_cmdl 

dk2rd2cmd2 

dk”wrlcmdl 

dk_wr_cmd2 

tries 

drive2 


equ  08H 
equ  1011H 
equ  1012E 
equ  10211 
equ  1022H 
equ  10 
equ  2 


iread  command 
i'write  command 

;CPM  logical  dsk  #  for 
Jdrive  2 


; - REMEX  Interface 


Controller  Ports  - 


cmd_reg 

status_reg 

p_addr_lo 

p_addr_hl 


equ  70E 
equ  7ia 
equ  72H 
equ  73H 


;ctrler's  base  in  CP/M-86 


CPM  DEVICE  SPECIFIC  CODE 
entered  via  label  tables  in  CPMMAST.CPG 


cseg  $ 


ret 


;no  special  action  required 


rxf lop_home: 
ret 


;no  special  action  required 


rxf  lop_seldslc! 
ret 


;no  special  action  required 


rxf  lop_settrlc; 
ret 


rxf lop_setsec; 
ret 


;no  special  action  required 


;no  special  action  required 


rxf lop_read: 


mo  V 

rwdir,0 

call 

request 

Jget  resource  {STNC.ASe) 

cmp 

uni t .drives 

;CP/M  logical  disk  No.  for 

Jz 

rdl 

JRemex  floppy  drive  2  (C:) 

rdl : 

mov 

Jmps 

bx , dk_rd_cmdl 
rdS 

isei  up  to  read  drive  1  (P: 

rd2: 

mov 

call 

bx.dk_rd_cmd2 

build.packet 

>set  up  to  read  drive  2 

call 

sead_packet 

jperform  the  read 

call 

xf r_buf fer 

;xfr  CPM  buffer  into  memory 

call 

release 

;free  resource  (STNC.Ac6/ 

mov 

ret 

al .  result 

i return  success/f ai lure  cod 

rxf lop_write: 

tno  V 

call 

crnp 

Jz 


rwdi r,l 
request 
uni t .drives 
wrtl 


irequest  ticket  number 
;CP/M  logical  disk  No.  for 
JHemex  floppy  drive  2  (C:) 


tsetup  write  to  drive  1  (B:) 


mov 

bz,dk  wr  cmdl 

Jmps 

wrt2 

wrtl : 

mov 

bz,dk_wr_cmd2 

wrt2: 

call 

build.packet 

call 

xf r_buf fer 

call  • 

send_ packet 

call 

release 

mov 

al ,  result 

ret 

fset  up  to  write  drive  2 


tfree  resource  (STNC.A66} 
t return  success/failure  code 


;  +-f  +  -f-i-++++++++-f+++f ++  +  ■*• +  -+-t+*-*-  ++-t+-r 

;  HSMEX  BLOPPI  DISS  SUBROUTINES 

;  ++  +  +++-*■•♦• +-*-  +  +  +  +  -*'  +  +  +  +  +  f  +  -r++^++-i-+  +  +  +  +  +  ++-4-  +  -*>++  +  +  +  -r  +  +  -4-«”r+  +  f+++  +  + 


bui ld_packet : 


push 

es 

mov 

ax,cmemseg 

mov 

es,az 

mov 

p_modif iers  ,bx 

mov 

p_status ,0 

mov 

ax,0000E 

mov 

al , track 

mov 

p  track  no, ax 

mov 

ax,0e00H 

add 

'  al, sector 

mov 

p_head_sect  ,ax 

mo  V 

p_mem_addr ,0100h 

mov 

plmsb ,000eh 

mov 

p_word_count ,64 

isave  es  re/;i5ter 
set  up  es  to  address  common 
memory  E000: 
enter  read  code  in  paclcet 
clear  packet  status  word 
clear  register 
get  track  # 

enter  track  #  in  packet 
set  head  no.  to  £ 
set  sector  no. 
put  head  S.  sec  ^  in  packet 
{address  of  CPM  buffer 
CPM  buffer  msb 
of  16  bit  words 


send.packet : 

push 
mov 
mo  V 
mov 
sendl : 
in 
and 
cmp 
jne 
mov 
out 
mo  V 
out 

V 


es 

ax,cmemseg  {common  memory  segemeat  = 
es»ax 

dk_cnt, tries  {load  count  for  retries 
ai , status_reg 

al,  dk_rdy_mask  {check  interface  ready 

al,08H  {is  it  ready? 

sendl  {if  not  ready  repeat 


al , 08H 
sendl 
al « IcH 
cmd_reg  ,al 
ax, 00£4n 
p_addr_lo ,al 
al.ah 


{load  extended  address 
{packet  offset 
{transfer  low  byte  out 


~  '^\  "w  %-  v-.',  "w  % 

>*■ 

out 

p_add r_hi ,al 

{transfer  hi  byte  out 

-  „ 

check.result: 

m 

mov 

ax, p_status 

{load  status  word 

cmp 

az,0001E 

{check  for  success 

« 

Je 

success. read 

cmp 

az , 0000H 

{check  for  failure 

Jae 

retry 

Jmps 

check.result 

retry: 

■v  i 

mov 

dk.err.code  ,al 

{save  error  code 

mov 

axT0 

{clear  status  word 

dec 

dk_cnt 

{reduce  retry  count 

Jnz 

send.packet 

{if  <>  0  try  a^ain 

mov 

result , 0?FH 

{return  failure 

code 

■ 

Jmps 

dk.execute.ret 

success  read: 

mov 

result ,00H 

{return  success 

code 

*%• 

dk_execute_ 

ret: 

pop 

es 

ret 

« 

xfr  buffer: 


push 

mov 

mo7 

mov 

mov 

mo  V 

mov 

cmp 

Jz 

zcb/r 

mov 

mov 

mov 


;^et  data  from  common  memory 
tand  load  into  local  memory 


xfr : 


es  !  push  ds 

es.dma^seg 

di ,dma_adr 

ax,  cmemsefr 

ds»az 

si, 0100b 

cx,64 

rvdi r, 0 

xfr 

si,di 

ax ,  ds 

es,ax 

ds ,  dma_se^f 


iset 


for  write  ooeration 


cld 

rep  movs  ax, ax 
pop  ds  !  pop  es 
ret 


Imove  as  IS-bit  words 


Data  Area 

++-++•+•+♦ +-r-f+++  +  -*'+  +  +  +  f+-r++  +  +^+++  +  +  +  +  -4-  +  +  +  +  ++  +  4.-,--^^  +  -f  +  -r+  ■^ 


; - Remex  Interface  Packet - 

{packet  located  in  common  memory  at  D00e:C0e4 


’j-T^Z^rryTTT^^rirr-ryr’ 


Vy 


r  • 


fv- 


org 

0004h 

;offset  of  packet 

p  modifiers 

rw 

1 

tfunction  &  logical  unit 

p  status 

rw 

1 

treturned  status 

p  track  ao 

nt 

1 

tselected  track  number 

p_head_sect 

TM 

1 

{selected  head/sector  number 

p  mem^addr 

rw 

1 

{buffer  address 

p  msb 

rw 

1 

{extended  bits  of  buffer  address 

p_word_couat 

rw 

1 

{slse  of  data  block 

’ 

■“■•'HI  sc 

vdr  Xa  Dxes"—— -i 

cseg 

:  $ 

dk  err  code 

d'o 

00H 

{returned  Remez  error  code 

dk  cat 

db 

00E 

result 

rb 

1 

rwd  ir 

rb 

1 

{0  =  read  {  1  =  write 
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PROGRAM  L! 
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fProg  Name 
•  Date 
;Modified 
iWritten  by 
;Por 

lAdvlsor 

iPurpose 


RZHASD2.A&6  (RSKSZ  HARD  DISK  ACCSSS  CODS) 

13  October  1982 

Transfer  Thru  Common  Memory /Ticket  Sync 
Tom  T.  Almqulst  and  David  S.  Stevens 
Thesis  (AEGIS  Modeling  Group) 

Professor  Sodres 

This  code  is  an  include  file  v/ln  CPMBI0S.A86. 
It  contains  the  code  necessary  to  access  the 
REMEZ  hard  disk  drive. 


Equates 


; -  Disk  Controller  command  bytes  and  masks  (REMEZ) 


hda_rdy_mask 

hdJc_rd_cmd 

hdk_wr3cmd 

hdkitries 

headO 


equ  08H 
equ  IdldE 
equ  1C20E 
equ  10 
equ  3 


pstrf  equ  9 


;read  command 
;write  command 

;CP/M  logical  dsk#  for  head 
;0  of  REMEZ  hard  disk 
tprint  string  function 


-  REMEZ  Interface  Controller  Ports 


hdk_CMD_reg  equ  70H 
hdk_status_reg  equ  71H 
hdk2addr_lo  equ  72H 
hdk_addr_hi  equ  73H 


Jctrler's  base  in  CP/M-86 


-B1 ocking/Deblocilng- 


una 

blksiz 

hst  siz 

hsispt 

hstblk 

secshf 

cpmspt 

sec  ms  k 

wrall 

wrdir 

wrual 


equ 

equ 

equ 

equ 

equ 

equ 

equ 

equ 

equ 

equ 

equ 


byte  ptr  [3X]  {name  for  byte  at  3X 


16384 
512 
39 

hstsiz/128 

2 


;CP/M  allocation  size 
ihost  disk  sector  size 
fhost  disk  sectors/trk 
fCP/M  sects/host  buff 
; log2(hstblk) 
hstblk  hstspt  ;CP/M  sectors/traca 
hstblk-1  ;sector  mask 
0  twrite  to  allocated 

1  ;write  to  directory 

2  fwrite  to  unallocated 


++•♦■+ +++•*.+++ 


m 


n 


DE¥ICE  SPECIEIC -CODE 

entered  from  the  main  CPMBIOS  via  label  tables 


CSEG  $ 

I  IMIT 

rzhard.lnlt: 

ret 


fCalled  from  INIT 


;home 

Rzhard  aome: 


entered  via  home  label  table 


mov 

al fhstvrt 

;checlc 

for 

pending 

write 

test 

al  «al 

Jnz 

homed 

• 

mov 

hstact  ,e 

;  clear 

host 

active 

flag 

homed : 
ret 


DISK 

seldsk: 

entered 

via 

.mov 

cl ,unit 

mov 

sekdsjCfCl 

t  est 

dl  ,1 

;ist 

Jnz 

contl 

;no 

mov 

hstact  ,0 

J  yes 

mov 

unacnt  «0 

contl : 
ret 


;SELECT  TRACK 
Rzhard_settric: 
mov 
ret 


enterd  via  seltrz  label  table 
sektrh  ,cz 


;SELECT  SECTOR 

Rzhard^setsec; 

mov 

ret 


entered  via  selsec  laoel  table 


selcsec  ,cl 


128 


iREAD  entered  via  read  label  table 


Hzbard_read: 

mov  unacnt,0 

mov  readoPtl 

mov  rsflag,! 

mov  wrtype.wrual 

Jmp  rwoper 


•read  selected  CP/h  sector 
fClear  unallocated  counter 
iread  operation 
imust  read  data 
; treat  as  unalloc 
;to  perform  the  read 


;WR  ITE 

enter  via  write  label  table 

Rxhard 

write 

• 

• 

;write  selected  C?/M 

mov 

readop,e 

fwrite  operation 

mov 

wrtype,cl 

cmp 

cl ,  vrual 

fwrite  unallocated? 

jnz 

chkuna 

tcheck  for  unalloc 

Jwrite  to 

unallocated,  set  parameters 

mov 

unacnt, (blksiz/12e)  ;nezt  unalloc  rec 

mov 

al , sekd sk 

;disk  to  seek 

mov 

unadsk, al 

;  unadsk  =  sekdsk 

mov 

az, sektrk 

mov 

unatrk,az 

funatrk  =  sektrk 

mov 

al , seksec 

mov 

unasec ,al 

Junasec  =  seksec 

;  f ++•►+  +  +++++  +  •♦•++•►  +  +*■♦••»■ +  +  T+T +•♦•■♦•+  +  ■♦•♦++  +  +  ■*•++ r +•*.  ++■♦•  ■r  +  -*-  + 

• 

f 

BLOCKING  &  DEBLOCKING  SUBROUTINES 

1  ♦+  ■r+ ++•♦•+ +++•*•+♦+++ ■r 4"+  + -“+f  +  +  +  — +  ^  + 

Chkuna 

• 

• 

; check  for 

write  to  unallocated  secto 

mo  V 

bz, of f set 

unacnt;poiat  "una"  at  UNACN 

mov 

al ,una 

test 

al  ,al 

iany  unalloc  remain? 

Jz 

alloc 

isklp  if  not 

;more 

unallo 

cated  records 

remain 

dec 

al 

funacnt  =  unacnt“l 

mo  V 

una,al 

mov 

al , sekdsk 

isame  di  sk? 

mov 

bz,  of  f  se  t 

unadsk 

cmp 

al ,una 

; sekdsk  =  unadsk? 

Jnz 

alloc 

;skip  if  not 

sector 


; disks  are  the  same 
AX,  unatrk 
AX,  sektrk 

alloc  isklp  if  not 


mov 
cmp 
J  nz 


; tracks  are  t he  same 


mov 

al»seksec 

;same  sector? 

mov 

hz. offset  ana sec 

;polnt  una  at  unasec 

cmp 

al*una 

iseksec  =  unasec? 

Jaz 

alloc 

fSkip  if  not 

match* 

move 

to  next  sector  for 

future  ref 

Inc 

una 

iunasec  =  unasec-*-! 

mov 

al.una 

>end  of  track? 

cmp 

al (Cpmspt 

;count  CP/M  sectors 

Jb 

noovf 

;skip  if  below 

overflow  to 

next  track 

mov 

una  *0 

; una sec  =  0 

inc 

unatrk 

;unatrk»unatrk-«-l 

noovf : 

imatch  found*  mark  as  unnecessary  read 

mov 

rsf  la^f  ,0 

;rsfla<r  =  0 

Jmps 

rwoper 

,*to  perform  the  write 

alloc: 

;not  an  unallocated  record*  requires  pre 

mov 

unacnt  *  0 

Junacnt  -  0 

mov 

rsfla«*l 

;rsflag  =  1 

;drop  through  to  rwope 

Common 

code 

for  RSAD  and  WRITS 

follows 

woper  : 

ienter  here  to  perform  the  read/write 

mov 

erf lag, 0 

Jno  errors  (yet) 

mov 

ai,  seksed 

, ‘compute  host  sector 

sub 

al,l 

mo  V 

cl,  secshf 

shr 

al  *cl 

mov 

sekhst ,al 

;bost  sector  to  seek 

active 

host 

sector? 

mov 

al ,  1 

xchg 

al  *hstact 

;alway5  becomes  1 

test 

al  *  al 

;was  it  already? 

Jz 

fllhst 

ifill  host  if  not 

host  buffer 

active,  same  as  seek  buffer? 

mov 

al ,  sekdsk 

cmp 

al  fhstdsk 

isekdsk  =  hstdsk? 

Jnz 

nomatch 

; same  disk,  same 

track? 

mov 

az*hsttrk 

cmp 

ax, sektrk 

Jhost  trk  same  as  seek 

Jnz 

nomatch 

same  dlsic. 

same  track,  same  buffer? 

mov 

al , sekhst 

130 


cmp 

al thstsec 

tsekhst  >  hstsec? 

J2 

match 

;skip  if  match 

Doroatch: 

fproper  disk. 

but  not  correct  sector 

mov 

al»  hstwrt 

test 

al  ,al 

;  dirty  buffer  7 

J2 

filhst 

;no,  don't  need  to  write 

call 

vritehst 

lyes,  clear  host  buff 

f ilhst : 

;may  have  to 

fill  the  host  buffer 

moT 

al tsekdsk 

1  mov  hstdsk.al 

mov 

az, sektrk 

I  mov  hsttrk,az 

mov 

al.sekhst 

!  mov  hstsec,al 

mov 

al , rsfla^ 

test 

al ,  al 

;need  to  read? 

fllhstl 

call 

readhst 

f llhstl: 

mov 

hstwrt ,0 

;no  pending  write 

match: 

;  copy 

data  to  or  from 

buffer  depending  on  readop 

mov 

al , seksec 

Jmask  buffer  number 

sub 

al,l 

and 

az , secmsk 

Ueast  signif  bits  masked 

mov 

cl, 7 

;shift  Isft  7 

shl 

az,cl 

;(»  128  =  2**7) 

has  relative  nost  buffer 

offset 

add 

az, offset  hstbuf  Jaz  has  buffer  address 

mov 

si  ,az 

Jput  in  source  index  reg 

mov 

dl,dma  adr 

fUser  buff  is  dest  if  readop 

push 

DS 

push 

ES 

jsave  segment  registers 

mov 

ES ,  dma_se^r 

;set  destseg  to  the  user  seg 

mov 

cz, 128/2 

;SI/DI  and  DS /ES  is  swapped 
;if  write  op 

{length  of  move  in  words 

mov 

al ,  readop 

test 

al  ,al 

{which  way? 

jnz 

rwmove 

{skip  if  read 

fwrite  operation,  mark  and  switch  direction 

mov 

hstwrt , 1 

{hstwrt  =  1  (dirty  buffer  ) 

zch^ 

si,di 

{source/dest  index  swap 

mov 

az,  DS 

mov 

ES ,  az 

mov 

DS,dma_se#? 

{setup  DS,ES  for  write 

rwtnove 


cld 

rep  fflovs 

AZ,AX 

tmove  as  16  bit  words 

pop 

ss 

pop 

PS 

irestore  segment  registers 

tdata  has  been 

moved  to/from  host  buffer 

cmp 

wrtype  ,wrdir 

;write  type  to  directory? 

mov 

al»erflag 

;in  case  of  errors 

Jnz 

return.rw 

;no  further  processing 

; clear  host  buffer  for  directory  write 

test 

al  ,al 

J  errors? 

Jnz 

return_rw 

tskip  if  so 

mov 

hstwrtT^ 

;buffer  written 

call 

wri tehst 

mov 

al , erf lag 

return  rw: 

ret 

hdk  rwdir,0 

1 

request 

Jget  resource  (SYMC.A86) 

bx.hdk  rd  cmd 

1 

hdk,bulld_packet 

1 

hdK  send  packet 

fPerform  the  read 

1 

hdk  xfr  buffer 

1 

release 

>free  resoTirce  (STNC.AS6) 

al ,hdk_r0Sult 

;ret  success/failure  code 

write_ast : 

mov 
mov 
cmp 
Jnz 
call 
mov 
call 
call 
call 
call 
mov 
Jmp 
wrt  err: 
mov 
call 


hdic_rwdir  ,1 
al  .Hst.dsic 
al ,user 
wrt_err 
request 
l)X,lidic_wr_cmd 
hdlE.buI  ld_packet 
hdk_xf r_buf fer 
hdic_5end_pacicet 
release 
al ,hdx_result 
wrt_ret 

bx, offset  wrtms^c 
omsg 


fget  resource  (STNC.A86) 
Jset  up  write  to  hard  disk 


tfree  resource  (STNC.A66) 
;ret  success/failure  code 


L32 


al,0ffh 


»return  error  to  CP/M 


mov 
wrt_ret : 
ret 


:  +++++++++++++•♦•++++++•*■•( 


•++•♦•++++ 


REMEZ  aARB  DISZ  SUBROUTINES 


h(iJc_bulld_paclcet :  ; packet  built  in  common  memory 


push 

.  es 

mov 

axtcmemseg 

mov 

es,  ax 

mov 

hdk_modif  lers  ,bx 

ienter  read  code  in  packet 

mov 

hdk  status, 0000H 

id  ear  packet  status  word 

mov 

AZ,0000E 

Jclear  register 

mov 

ax,hst_trk 

•get  track  no. 

mov 

hdk  track  no, AX 

ienter  track  no.  in  packet 

mov 

AI,0000H  ~ 

Jclear  register 

mov 

ah ,hst.dsk 

sub 

ah,head0 

{determine  head  # 

mov 

AL,hst_sec 

iset  sector  # 

add 

ax,l 

mov 

hdk  head  sect  ,AI 

iload  in  pacxet 

mov 

hdk  mem  addr,0100h  iaddress  of  CP/M  buffer 

mov 

hdk_msb  ,000eh 

{common  memory  seg 

mov 

hdk*word_cnt ,256 

;#  of  16  bit  words 

pop 

es 

ret 

lidk_send_packet : 


push  es 

mov  ax.cmemseg 

mov  es,ax 

mov  hdlE_cnt  ,hdic_trie5  ;ioad  count  for  retries 
send_hdk_packet;  ~ 

la  AL,  jadk_status_reg 

and  AL,hdk_rdy_mask  Jcheck  interface  ready 

cmp  AL,08S  ;is  it  ready? 

Jne  send_hdk_packet  Jif  not  ready  repeat 

mov  al.lch 

out  hdk_cmd_reg ,AL  Jload  extended  address 

mov  ax,0004h 

oat  hdk_addr_lo ,AL  itransfer  low  byte  out 

mov  AL , AH 

out  hdk_addr_ni  ,AL  itransfer  hi  byte  out 

check_hdk_resul t ; 

mov  ax ,hdk_status  iload  status  word 

cmp  AZ, 00015  fcheck  for  success 


je  h(i]c_success_read 

cmp  AZ.0000H  icheck  for  failure 

Jne  hdlr.retry 

Jmps  check_hdk_result 

hdk_retry: 

”mov  hdk_err_code,AL  ;save  error  code 

mov  hdk~status»0  ; clear  status  word 

dec  hdk_cnt  » reduce  retry  count 

Jnz  send_hdk_packet  ;if  <>  0  try  a#rain 

mov  hdk_resuit ,0rFH  » return  failure  code 

Jmps  hdk"execute_ret 

hdk_success_  readT 

mov  ~  hdk_result ,00a  ; return  success  code 

tdk_execute_ret: 
pop  es 

ret 


hd]t  xfr  buffer: 


Hransfer  data  from  common 
{memory  to  local  memory 


push 

mov 

mov 

mov 

mov 

mov 

mov 

mov 

cmp 

Jz 

xch^ 
mov 
mov 
mov 
mov 
hdk  xfr: 
cld 
rep 
pop 
ret 


es  !  pusn  ds 

ax,cs 

es,ax 

di, offset  hsthuf 

ax,cmemseg 

ds,ax 

si,0100h 

cx,256 

hdk  rvdir,0 

hdk'xfr 

si,di 

ax,  ds 

es  ,ax 

ax,  cs 

ds,ax 


movs  ax, ax 
ds  I  pop  es 


;  +++-I 


■++++++++++-►+- 


Data  Segment  Area 

• -^  +  +  +++  +  +  +  +  +  -r-♦•+-^  +  +T+  +  ■►  +  ■‘■■♦•■“++■^  +  f+-+■^  +  +  + -4.+  —  +  ^- 


; - Remex  Interface  Packet  — 

{packet  built  in  common  memory  at  E000:0004 


eseg 

org  0004h  {offset  of  packet 
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MIC 

_modif iers 

TV 

1 

^function 

&  logical  unit 

hdk 

_status 

TV 

1 

{returned 

status 

hdk 

_track_np 

TV 

1 

{selected 

track  number 

Mk 

”head_sect 

TV 

1 

{selected 

head/sector  number 

Mk 

_meni_addr 

TV 

1 

{buffer  address 

hdk 

~msb~ 

TV 

1 

{extended 

bits  of  buffer  address 

hdk 

_word_cat 

TV 

1 

{size  of  data  block 

cseg 

:  $ 

- Misc  Variables - 


hdk_err_ 

.code 

db 

eeH 

{returned  Remez  error  code 

hdk  cnt 

db 

hdk_resul t 

rb 

1 

{success/failure  code 

ndk_rwdir 

rb 

1 

sek_dsk 

rb 

1 

{seek  disk  number 

sek'trk 

rw 

1 

{seek  track  number 

sek_sec 

rb 

1 

{seek  sector  number 

hst_dsk 

rb 

1 

{host  disk  number 

hst_trk 

TV 

1 

{host  tracx  number 

hst_sec 

rb 

1 

{host  sector  number 

sek~hst 

rb 

1 

{seek  shr  secshf 

nst_act 

rb 

1 

{host  active  flag 

hst  _wrt 

r  b 

1 

{host  written  flag 

una_cnt 

rb 

1 

{unalloc  rec  cnt 

una_dsk 

rb 

1 

{last  unalloc  disk 

una_trk 

TV 

1 

{last  unalloc  track 

una_sec 

rb 

1 

{last  unalloc  sector 

erf  lag 

rb 

1 

{error  reporting 

rsf lag 

rb 

1 

{read  sector  flag 

readop 

rb 

1 

fl  if  read  operation 

wrtype 

rb 

1 

{write  operation  type 

dma_of  f 

TV 

1 

{last  dma  offset 

hst  buf 

rb 

hstsi z 

{host  buffer 

wrtmsg 

db 

cr 

,if 

Write  Access  Mot  Permitted  On  This' 

db 

Drive 

',0 

4 


4 
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APPENBIZ  a 

PE06RAM'Lls5iNG  OF  CPMMAST.DEF 
The  following  disk  definition  statements  were  used  in 
this  thesis.  The  command  "GENBEF  CPMMAST.DEF"  is  executed 
to  produce  CPMMAST.LIB  which  must  be  assembled  into  the  BIOS 
using  an  "include'*  command, 
disks  7 

diskdef  0,1.26.0,1024.71,32,0,2 
diskdef  1,1,26,6,1024,243,64.64,2 
diskdef  2,1 

diskdef  3,1 ,156 ,0,16384,275,128,0,1 

diskdef  4,3 

diskdef  5,3 

diskdef  6.3 

endef 
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APPENDIX  H 

PROGRAM'’ IISTlfiS  5F  CPMMAST.LIE 

When  GENDEP  is  executed  using  CPMMAST.DEF  as  the  source 
file,  CPMKAST.LIB  is  created.  The  listing  which  follow  is 
the  code  generated  by  GSNDE?  and  must  be  assembled  into  the 


BIOS  with  an  include  command. 


» 


• 

• 

DISKS  7 

dpbase 

equ 

$ 

dpe0 

dw 

Zlt0.a000h 

dw 

0000h,0000h 

dw 

dirbuf  fdpba 

dw 

cstr0,alT0 

dpel 

dw 

zltl,W000h 

dw 

0000h,0000h 

dw 

dirbuf ,dpbl 

dw 

cswl ,alvl 

dpe2 

dw 

zlt2,0000h 

d  w 

0000h,0000h 

dw 

dirbuf •dpba 

dw 

csv2,alv2 

dpe3 

dw 

zlt3,0000h 

d  w 

0000h,0000h 

dw 

di rbuf ,dpb3 

dw 

csT3,alv3 

dped 

dw 

zlt4,0000h 

dw 

0000h,0000h 

dw 

dirbuf ,dpb4 

d  w 

csv4,alT4 

dpeo 

dw 

zlt5,0000h 

dw 

2000h.0000h 

dw 

dirbuf ,dpb5 

d  w 

csv5,alv5 

dpe6 

dw 

Xlt6,00e0h 

dw 

0000h,0000h 

dw 

di r buf ,dpbb 

d  w 

csv6 ,alv6 

• 

f 

DISKDEF  0,1,26 

dpb0 

equ 

Offset  $ 

dw 

26 

do 

3 

db 

7 

;Base  of  DisX  Parameter  Blocxs 
•Translate  Table 

•  Scratch  Area 

•Dir  Buff,  Farm  Bloch 
•Chech,  Alloc  Tectors 
;Transiate  Table 
;Scratcii  Area 
;Dir  Buff,  Farm  Bloch 
•Chech,  Alloc  Tectors 
;Translate  Table 
•Scratch  Area 

•  Dir  Buff,  Farm  31oc£ 

;Chech,  Alloc  Tectors 
;Translate  Table 
•Scratch  Area 

•Dir  Buff,  Farm  Bloch 
•Chech,  Alloc  Tectors 
•Translate  Table 
•Scratch  Area 
;Dir  Buff,  Farm  Bloch 
•Chech,  Alloc  Tectors 
•Translate  Taole 
•Scratch  Area 
•Dir  Buff,  Farm  Bloch 
•Chech,  Alloc  Tectors 
•Translate  Table 
•Scratch  Area 
•Dir  Buff,  Farm  Bloch 
;Chech,  Alloc  Tectors 
3,1<>24,71,32,0,2 
;Dlsh  Parameter  Bloch 
jSectors  Per  Trach 
;Bloch  Shift 
•Bloch  Mash 


-A  ^  .S  J»  ••  A*»**'**'.”4 

u 

? 

I-' 

db 

0 

fEztnt  MasJc 

dv 

70 

iDlsk  Size  -  1 

dv 

31 

fDirectory  Max 

r- 

db 

128 

;a11oc0 

] 

db 

0 

;aiioci 

dw 

0 

rCheck  Size 

dw 

2 

;0ffset 

iit0 

equ 

offset  $ 

iTranslate  Table 

db 

1 » 2 1 3  *4 

,  * 

db 

5, 6. 7. a 

i 

db 

9,10,11,12 

f 

db 

13,14,15,16 

*■ 

u: 

db 

17,18,19,20 

l; 

db 

21,22,23,24 

w 

db 

25,26 

als0 

equ 

9 

iAllocation  Vector  Size 

i  CSS0 

equ 

d 

(Check  Vector  Size 

DISKDEF  1,1 

,26,6,1324,243,64,64,2 

apbl 

eq  u 

offset  $ 

;Disk  Parameter  Block 

dw 

26 

(Sectors  Per  Track 

J . 

db 

3 

(Blocx  Shift 

*• 

db 

7 

;Blocic  Mask 

db 

3 

(Extnt  Mask 

dw 

242 

(Disk  Size  -  1 

dw 

63 

(Directory  Max 

; 

db 

192 

;A11oc0 

•. 

db 

e 

lAllocl 

dw 

16 

(Check  Size 

1 

dw 

2 

(Offset 

'  xltl 

equ 

offset  $ 

(Translate  Table 

db 

1,7,13,19 

db 

25,5,11,17 

db 

23  f  3  f  9  f lo 

i 

db 

21,2,8,14 

db 

20,26,6 ,12 

> 

db 

18,24,4,10 

db 

16,22 

alsl 

equ 

31 

(Allocation  Vector  Size 

C  S  S 1 

equ 

16 

;Check  Vector  Size 

• 

t 

DISKDEF  2,1 

^  dpbS 

equ 

dpbl 

(Equivalent  Parameters 

■  als2 

equ 

alsl 

(Same  Allocation  Vector  Size 

css2 

equ 

cssl 

;Same  Checksum  Vector  Size 

xlt2 

equ 

xltl 

;Same  Translate  Table 

• 

f 

DISKDEF  3,1 

,156,3,16384,275,123,0,1 

;•  dpb3 

equ 

offset  $ 

(Disk  Parameter  Block 

dw 

156 

(Sectors  Per  Track 

db 

7 

(Block  Shift 

db 

127 

;Block  Mask 

db 

7 

;Sxtat  Mask 

dw 

274 

;Disk  Size  -  1 

r 

d  w 

127 

JDireciory  Max 

138 

r 

■  ■  .V  -» 

.  .. 

/ 

db 

126 

;aiioc0 

db 

0 

Ullocl 

dv 

0 

*Checlc  Size 

dv 

1 

;Offset 

xlt3 

equ 

offset  $ 

fTranslate  Table 

db 

1. 2*3*4 

db 

5*6*7 *8 

db 

9*10,11*12 

db 

13*14*15*16 

db 

17*18*19*20 

db 

21*22,23,24 

db 

25*26,27,28 

db 

29,30,31,32 

db 

33,34,35,36 

db 

37,38,39,40 

db 

41,42,43,44 

db 

45,46,47,48 

db 

49,50,51.52 

db 

53,54,55,56 

db 

57,58,59,60 

db 

61,62,63,64 

db 

65,66,67,68 

db 

69,70,71,72 

db 

73,74,75,76 

db 

77,78,79,80 

db 

81,82,63,84 

db 

85,86,87,88 

db 

89,90,91,92 

db 

93,94,95,96 

db 

97,98,99,100 

db 

101,102,103,104 

db 

105,106 ,107,108 

db 

109,110,111,112 

db 

113,114,115,116 

db 

117,118 ,119,120 

db 

121,122,123,124 

db 

125,126,127,128 

db 

129,130 ,131 ,132 

db 

133,134,135,136 

db 

137,138  ,139,140 

db 

141,142,143,144 

db 

145,146,147,146 

db 

149,150,151 ,152 

db 

153,154,155,156 

als3 

eq  u 

35 

lAllocation  Vector  Size 

css3 

equ 

0 

iChecic  Vector  Size 

• 

9 

DISKBEF  4,3 

(ipb4 

equ 

dpb3 

iSqulvalent  Parameters 

als4 

equ 

als3 

fSame  Allocation  Vector  SI 

CSS4 

equ 

css3 

;Same  Cbeclcsum  Vector  Size 

Xlt4 

eq  u 

xlt3 

iSame  Translate  Table 

• 

I 

DISKDEF  5,3 

139 


dpbS 

equ 

dpb3 

> Equivalent  Parameters 

als5 

equ 

als3 

fSame  Allocation  Vector  Si: 

css5 

equ 

css3 

;Same  Checksum  Vector  Size 

zlt5 

equ 

xlt3 

fSame  Translate  Table 

• 

$ 

CISKUEF 

6.? 

dpb6 

equ 

dpb3 

; Equivalent  Parameters 

als6 

equ 

als3 

tSame  Allocation  Vector  Si 

css6 

equ 

css3 

;Same  Checksum  Vector  Size 

xlt6 

• 

f 

• 

equ 

xlt3 

ENDET 

>5ame  Translate  Table 

f 

• 

f 

• 

Uninitialized  Scratch 

Memory  Follows: 

f 

begdat 

equ 

offset 

$ 

;Start  of  Scratch  Area 

dirbuf 

rs 

128 

♦Directory  Buffer 

alv0 

rs 

als0 

♦Alloc  Vector 

CSV0 

rs 

CSS0 

♦Check  Vector 

alvl 

rs 

al  si 

♦Alloc  Vector 

csvl 

rs 

cssl 

♦Check  Vector 

al72 

rs 

als2 

♦Alloc  Vector 

csv2 

rs 

css2 

♦Check  Vector 

alv3 

rs 

als3 

♦Alloc  Vector 

csv3 

rs 

css3 

♦Check  Vector 

alv4 

rs 

als4 

♦Alloc  Vector 

csv4 

rs 

css4 

;Check  vector 

alv5 

rs 

als5 

♦Alloc  Vector 

csv5 

rs 

css5 

♦Check  Vector 

alv6 

rs 

also 

♦Alloc  Vector 

CS76 

rs 

css6 

♦Check  Vector 

enddat 

equ 

offset 

$ 

♦End  of  Scratch  Area 

datsiz 

equ 

db 

offset 

0 

$-beedat  {Size  of  Scratch  Area 
JMarlcs  End  of  Module 

APPINDIX  I 

PROG BAM  LISflNG~5F  INTEIDSK.Ade 


(Pros  Name 
;Date 

fWrltten  by 
.•Modified  by 
.For 

{Advisor 

{Purpose 


INT£LDSK.Ae6  (MBS  S.  Density  Floppy  Routines) 

9  Aug  1982 

Jim  John,  SMC  1277,  649-0592 
Tom  T.  Almquist  and  David  Stevens 
Thesis  (AEGIS  Modeling  Group) 

Professor  M.L.  Cotton 

This  code  is  an  include  file  v/in  CPMBI0S.A86. 
It  contains  the  routines  for  using  the  MDS 
Single  Density  Floppy  DisJr.  It  is  configured 
for  a  single  iSCB  &6/12A  and  does  not  use 
common  memory  for  I/O. 


{port  addresses 


base 

equ  078h 

{iSBC201  port  address  base 

rrtport 

equ  base+1 

{read  result  type  (input) 

rrbport 

equ  base-^S 

{read  result  byte  (input) 

resport 

equ  base+7 

{reset  iSBC201  (output) 

dstport 

equ  base 

{read  subsystem  status 

{ (input ) 

M 

■ 

ialport 

equ  base+1 

{write  iopb  addr  low 
{ (output ) 

* 

•  _  ’ 

iahport 

equ  base+2 

{write  iopb  addr  high 
{ (output ) 

{command 

codes  &  masks 

■ 

rdc  ode 

equ  4 

{read  command  code 

vreode 

equ  6 

{write  command  code 

r_  ■- 

ewe  ode 

equ  80H 

{channel  command  code 

intbit 

equ  04h 

{interrupt  bit  masK 

4 

retries 

equ  10 

{for  disk  i/o,  before  error 

0 


;  *+-+++++ >.*+++ -4.+ T +4-1.4. + 

ENTRT  POINT  ROUTINES 


» 
f 

9  ++++-*-♦--♦•+- 


inteldslc_ ini t :  {initialize  lisle  controller 

{actually  lone  by  iSBC86/12  monitor 

i  ret 


h-- 
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inteldsk.home: 

ret 


lnteldsJc_seldslc 

ret 


lnteldsic_settr]c: 

ret 


i 

Hi 

f 

inteldsk_setsec: 

ret 

• 

> 

inteldsk_read:  {read  sector 

mov  cl ,4 

from  disk 

mov  al.unit 

{combine  disk  selection 

3 

sal  al.cl 

{with  opcode 

or  al.rdcode 

{to  make  io  command  for 

read 

mov  lo_com,al 

{set  it  in  comd  word  of 

iopb 

call  dsk_lo 

{and  execute  it 

m 

ret 

inteldsk_ write:  iwrite  to  disk 

mov  cl , 4 
mov  alfUnlt 
sal  alfCl 
or  al.wrcode 
mov  io_com,al 
call  dsk_lo 
ret 


{create  lo  command  for  write 


;go  do  it 


SUBROUTINES 

» -r + -r  •♦■+•♦■ +  +  >-  +  -?•+  +  ++++++■»•■••  +  -■*•+  +  +  - 


+  +  +  +  +  +  ^  + 


dsk  io: 


{execute  disk  read  or  write  function  for 
;iS3C201  controller.  Sets  un  remainder  of 
{iopb  and  sends  its  addr  to  the  controller 
{then  polls  for  a  response  and  checks  for 
{error  conditions. 


mov  lo  chw.cwcode 


{set  no  wait  code  for  channel 


ftransfer  1  sector 
fset  up  iopb  triE  and  sect 


mow 

io.nsc, 1 

raov 

alysector 

mow 

io_sec,al 

mov 

al t  track 

mov 

lo_trk,al 

mow 

cl  *4 

mov 

aZfdma.seg 

sal 

ax,  cl 

add 

ax, dma. ad r 

mov 

io_adh,ah 

mov 

io~adl, al 

mov 

try  cnt, retries 

diol : 

in  al.rrtport 

in  al.rrbport 

jro  V 

cl,  4 

mov 

ax,cs 

sal 

ax  ,cl 

add 

ax.offset  iopb 

out 

ialport ,al 

mov 

cl, 8 

sar 

ax,  cl 

out 

lahport,al 

dio2: 

in  al.dstport 

and 

al , intbit 

Jz  dio2 

in  a 

,1 ,  rrtport 

or  al,al 

Jz  dio3 

in  a 

1 , rrbport 

Jmps 

>  dio4 

dlo3 : 

in  al.rrbport 

or  a 

l,al 

Jz  dio6 

dio4: 

dec 

try  cnt 

Jnz 

dioi 

or  al, error 

dio6: 

ret 

; recombine  dma  seg  and  addr 


;set  It  in  addr  word  of  iopb 


iclear  controller 
;^et  address  of  iopb 


;and  send  it  out 


;wait  for  contrler  interrupt 


ichecic  completion  code 


;  status  chgd.  Ignore  result 
;and  retry 
tcbeck  io  result 

iret  with  al=0  if  no  error 
jerror  if  we  got  here 
Jdecmt  count  and  try  again 
itry  again  if  any  left 
Jset  permanent  error  code 


■ -f ♦  +  +-  +  +  +  +  ++ -r  +  4. -t- ♦ 

PRIVATE  DATA  AilZA 


-4.+  >  +  +  + 


+  ++  +  -*•  +  +•+- 


iopb 

rb  ' 

7 

»i/o  parameter  block 

io_ 

chw 

equ 

iopb 

>iopb  channel  byte 

lO- 

com 

equ 

iopb 

1 

icommand  byte 

io_ 

nsc 

equ 

iopb 

2 

Jsectors  to  xfer  (always  i; 

iol 

trk 

equ 

iopb 

3 

tselected  track 

sec 

equ 

iopb 

> 

4 

fselected  sector 

lo_ 

adl 

eq  u 

iopb 

+ 

5 

Jphyslcal  address  for  S3C201 

adh 

equ 

iopb 

+ 

6 

APPINBIZ  J 

PROGHAM  LISflNG'Of  LDCPM.A86 


Prog  N«ne  :  LI)CPn.A86 

Vritten  by  :  T.T.  Almqulst  and  D.  Stevens 

:  This  program  reads  tRe  file  entitled 
:  CPMSLATE.CMD  into  common  memory  beginning  at 
:  location  £080:500. 


cseg 

org  0100b 

jmp  start 

Equates 


cr 

equ 

edh 

•carriage  return 

If 

equ 

0ab 

•line  feed 

drive 

equ 

000411 

•target  C?/M  drive  # 

bdos_lnt 

equ 

224 

•interupt  vector 

pstrf 

equ 

9 

•print  string  function 

seldsbf 

equ 

14 

•select  disk  function 

openf 

equ 

15 

•open  file  function 

readf 

equ 

20 

•read  function 

dtraf 

equ 

26 

•set  dma  offset  function 

dmabf 

equ 

51 

•set  dma  base  function 

Subroutines 

seldisb:  ;select  target  lisA  # 

mov  cl,seldsAf 
mov  dx, drive 

Jmp  sys_vec 


openfnc:  ;opea  file  denoted  in  fob 

mov  cl.openf 

mov  dx, offset  fcb 


setdmab: 


fSet  dma  base  address 


cltdmabf 

sys_Tec 


setdma : 

mov 

Jmp 

cl idnaf 
sys.vec 

iset  dma  offset 

read: 

;read  128  bytes  from  file 

mov 

dx, off set  fcb 

»in  fcb 

mov 

cl , readf 

Jmp 

sys_vec 

msg: 

fprint  a  character  string 

mov 

cl, pstrf 

;end  of  string  denoted  by  0 

Jmp 

sys_vec 

sys.vec : 

;execute  bdos  function  call 

int 

bdos_int 

ret 

Main  Program 


Start : 


call 

call 

cmp 

Jne 

mov 

call 

Jmp 

coat : 
mov 
call 
mov 
call 
call 


seldlsic  fSelect  desired  disic 

openfnc  iopen  file 

al,255  tif  file  not  found 

coat 

dx, offset  nofile 

msg  fprint  error  msg 

stop 


dx,cs  tsave  1st  page  in  local 

setdmab  Jmemory 

dx, off set  pagel 
jetdma 

read  ;read  1st  page 
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;read  file  into  common  memory 


F 

hv 

mov 

dz,0e000h 

;set  dma  base  to  common 

1 

call 

setdmab 

;memory 

1  *' 

US 

mov 

dz,0500h 

(desired  offset 

•Vi 

readf ile: 

call 

setdma 

h  / 

push 

dz 

rwv 

call 

read 

;read  126  byte  pa?e 

mE 

cmp 

al,01h 

;read  complete  7 

Je 

done 

.'1- 

cmp 

al ,  00h 

;  repeat 

■  ‘t 

je 

contread 

mov 

dx,of f set 

rerr  ;othervise  print  read  error 

i 

a 

call 

msg 

Jmp 

stop 

contread: 

.  - 

pop 

dz 

add 

dz ,080h 

; increment  dma  offset  for 

Jmp 

readf ile 

;nezt  pa?e 

1' 

done : 

»“  • 

mov 

dx , offset 

fms?  Jprint  completion  ms? 

call 

ms? 

1 

stop : 

mov 

cl , 00h 

♦return  to  CP/M 

mov 

dl ,00h 

int 

bdos_int 

• 

f 

Data 

»  • 

»  • 

nof lie 

dh 

cr,lf  ,'CPMSLAVZ.CMB  Not  Found  On  This  Dlsic$ 

•  ,- 

» 

rerr 

dh 

cr ,lf , 'Read  Error$ ' 

■ 

fmsg 

dh 

c r, If CPMSLAVE.CMD  Loaded  into  Common  ' 

» -  - 

do 

>emory$ ' 

■ 

fcb 

db 

04, 'CPMSLAVE','CMD',0,0,0,0,3,0,0,0,0,0,0,0 

■!■;- 

db 

0,0, 0,0,0 

,0.0, 0»0 

;  , 

pagel 

rs 

128 

■  ' 

db 

0 

end 
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PROGRAM  LIST 


SfSNDIX  I 
TlNG  of  LLBOOT. 


A86: 


Prog  Name 
Written  Wy 


LDB00T.A86 

T.?.  Almquist  and  0.  Stevens 

This  program  loads  the  boot  loader  into 

common  memory  and  is  used  by  slave  66/12AS. 


cseg 


0100h 

start 


Equates 


cr 

equ 

0dh 

;carrlage  return 

If 

equ 

0a  h 

;ilne  feed 

drive 

equ 

0004h 

; target  CP/M  drive  # 

bdos.int 

equ 

224 

?interupt  vector 

pstrf 

equ 

9 

;print  string  function 

seldslcf 

equ 

14 

^select  dish  function 

openf 

equ 

15 

;open  file  function 

readf 

equ 

20 

iread  function 

dmaf 

equ 

26 

;set  dma  offset  function 

dmabf 

equ 

51 

;set  dma  base  function 

Subroutines 


seldisic: 


iselect  target  disk  » 


clf seldsAf 
dx, drive 
sys  vec 


openf nc : 


;open  file  denoted  in  fcb 


cl , openf 

dx, offset  fcb 

sys_vec 


setdmal) 


fSet  dna  base  address 


moY 

cltdmabf 

Jmp 

sys_vec 

setdma: 

iset  dma  offset 

moY 

cltdmaf 

Jrap 

sys_vec 

read: 

iread  128  bytes  from  file 
•in  fcb 

mov 

dx, offset  fcb 

mov 

cl . readf 

Jnp 

sys.vec 

msg : 

;print  a  character  string 
iend  of  string  denoted  by  0 

mov 

cl , pstrf 

JMP 

sy  s_vec 

sys_vec : 


;execute  bdos  function  call 


int 

ret 


bdos  int 


Main  Program 


Start : 


call 

seldlsic 

Jselect  desired  dl 

call 

openf nc 

;open  file 

cmp 

al,255 

>if  file  not  found 

Jne 

cont 

mov 

dx, offset 

nofile 

call 

msg 

fprint  error  msg 

Jmp 

stop 

• 

'  • 

mov 

dx,cs 

isave  1st  page  in 

call 

set dma b 

imemory 

mov 

dx, of f set 

pagel 

call 

setdma 

call 

read 

ir»ad  1st  page 

Local 


tread  file  into  comroom  memory 


mov 

dZt0e000]i 

fset  dma  base  to  common 

call 

setdmab 

tmemory 

mov 

dz  1 0400h 

tdesired  offset 

readf lie: 

call 

setdma 

push 

dz 

call 

read 

tread  12S  byte  page 

cmp 

al ,  0111 

tread  complete  ? 

Je 

done 

cmp 

al ,  00h 

:  repeat 

je 

contread 

mov 

dz, offset 

rerr 

t otherwise  print  read 

error 

call 

msg 

jmp 

stop 

contread: 

pop 

dz 

add 

dz ,  08 0h 

t increment  dma  offset 

for 

Jmp 

readfile 

tnezt  page 

done: 

mov 

dz .offset 

fmsg 

;print  completion  msg 

call 

msg 

stop: 

mov 

cl ,  00h 

treturn  to  CP/M 

mov  dl«0<9h 

int  Mos  int 


Data 


nofile 

do 

cr, If , 'BOOT  .CMD  Not  Found  On  This  Disk$' 

rerr 

ib 

cr, If , 'Read  srror?  ' 

fmsg 

db 

cr, If , 'BOOT.CMD  Loaded  into  Common  Memory$' 

f  CO 

do 

04, 'BOOT  ','CMD', 0,0, 0,0, 0,0, 0,0, 0,0, 0.0 

db 

0,0, 0,0, 0,0,0, 0,0 

pagel 

rs 

128 

db 

0 

(-1 
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PROGRAM  LISTING  OF  B00T.A86 


;Prog  Name  :  B00T.A66 

(Written  by  :  T.Almquist  and  D.  Stevens 

;Date  :  16  October  1982 

;  :  This  program  is  the  boot  loader  used  by 

;  ;  slave  86/12As  to  load  CP/M-86. 

;  Equates 

load_addr  equ  O4O0h 
cpm_addr  equ  0500h 

»  Main  Program 


cseg 


call 

request 

(get  ticJcet  number 

mo  V 

az,0040h 

(Set  es  to  CP/M  segment  # 

mov 

es,ax 

mo  V 

di,0000h 

(Set  desired  offset 

mov 

az  ,0e000h 

(Set  ds  to  common  memory 

mov 

ds,  az 

(Segment  # 

mov 

si , cpm_addr 

;CPM. SLAVE  offset 

mov 

cz, la00h 

(number  of  bytes  to  move 

cld 

(from  common  memory  to 

rep  movs 

az ,  ax 

(local  memory 

call 

release 

(increment  server  # 

jmpf 

dword  pir  bios_ 

offset  +  load  addr 

(transfer  to  CP/M 


Include  File 


include  sy3c.a86  (for  sharing  common  memory 

(  Data 

bios_offset  dw  2500b  (C?/M  Jump  vector 

bios.seg  dw  e040h 
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PROGRAM  LISTING  OF  LOGIN. A86 


Prog  Name  :  LOGIN. A86 

Date  :  15  October  1982 

Written  by  :  T.  Almquist  and  D.  Stevens 

:  This  program  contains  the  code  necessary  to 
:  permit  only  one  user  at  a  time  to  be  logged 
:  on  to  any  I/O  storage  device. 

Equates 


busy  equ  0ffh  ;busy  indicator 

ndsks  equ  7  ; number  of  CP/M  disks 

Subroutines 


cseg  $ 

login : 

push  es 

mov  az.cmemseg 
mov  es,az 

log0 : 

mov  bx, offset  logmsgP 

call  pmsg 

call  conin 

cmp  al,31h 

J1  log0 

cmp  al,34h 

Jg  logo 

mov  console, al 

logl : 

mov  bx, offset  logmsgl 
call  pmsg 
call  conin 
cmp  al,41h 
J1  logl 

cmp  al,40h  +  ndsks 
Jg  logl 
and  alfOfh 
sub  al,l 
mov  user.al 


>set  up  to  address  ooirmon 
;  memory 


;get  console  number 

;ret  console  number  in  al 
iensure  response  is  between 
;i  and  4 


»save  console  number 

iinital  login  msg 

;prlnt  message 

fget  login  disk 

iwithin  range  defined  by 

;CPMMAST.DEF 

fgreater  than  g: 

Jstrip  upper  nibble 
lUormallze  to  zero 
;save  login  user  disk 


;determine  If  disk  Is  free 


i 


xor 

hZtbz 

mov 

bl,al 

;set  up  to  index  logtbl 

nov 

alt  busy 

lock 

zchg  altlogtbl  [bz] 

test 

al,al 

;is  disk  free? 

Jz 

log2 

lif  so*  enter  console  # 

emp 

al tconsole 

fis  console  already  logged 

Jnz 

restore 

»lf  not*  restore  logtbl 

log2: 

zor 

bz.bz 

tclear  bx 

mov 

bl .user 

.offset  in  logtbl 

mov 

al  .console 

lock 

zchg  al  tlogtbl  [bzl 

tenter  console  number 

Jnp 

log_ret 

restore: 

lock 

zchg  al  tlogtbl  [bzl 

;restore  logtbl  entry 

mov 

bZt offset  logmsgS 

;re(iuest  another  disk  # 

call 

pmsg 

Jmp 

logl 

lo<;_ret : 

.  pop 

es 

ret 

nit_lo#rin : 

tlnitialize  logtbl  entries 

push 

es 

.address  common  memory 

mov 

aztcmemseg 

mov 

es.az 

zor 

bZtbz 

zor 

CZ  tCZ 

mov 

cl  .ndsks 

;entry  for  each  disk 

again: 

logtbl  Cbzl  ,(d 

mov 

finltialize  elements  of 

Inc 

bz 

; logtbl  to  0 

loop 

again 

pop 

es 

ret 

Data  Area 


user 

rb 

1 

console 

rb 

1 

logmsgl 

db 

cr ,lf ,  'Enter 

Login  Dis£  Letter 

(A,D,E,F,G) 

.  ■ 

lb 

cr,lf  ,2 

logms g2 

db 

cr ,lf ,  'Enter 

Console  Number  (1 

,2.3,4)' 

153 


lo^ms^3 


db  cr.lf*0 

db  cr.lf.'Dislc  In  Use - Beselect '  ,cr  ,lf  ,e 

eses 
org  20b 


logtbl 


rb  ndsks 


•allot  memory  for  logtbl 


AfflNCll  N 

PHOGIAM  LISfiNG  Of  STNC.A86 


Prog  Name  :S7nch.A86 

Sate  :7  October  1982 

Written  by  :NicIc  Hammond 

Modified  by  :T.  Almquist  and  0.  Stevens 

for  : Thesis 

Advisor  :Professor  lodres 

Purpose  tProvide  synchronizations  of  CPM/86  read 

and  write  operations  to  the  MBB-60  bubble 

memory  board  and  the  RSM£X  Data  Warehouse. 


Synchronization  Routine 


Equates 


cmemseg  equ  0e000h  ; segment  address  of 

; common  memory 

dcount  equ  100  ibus  contention  time  delay 

Subroutines 


cseg  $ 

tichet:  treturn  the  next  ticket  number  in 

ibx 

xor  ax, ax  ;set  reserved  value 

lock  xchg  ax, next  ;get  ticket  number 

test  ax, ax 

Jz  ticket  ;repeat  if  reserved 

mov  bz,ax  ^return  next  ticket 

inc  ax 
Jaz  ticl 
inc  ax 
mov  next, ax 


ticl 


fSxlp  reserved  value 
; increment  ticket  number 


L* 

ad vance: 

Inc 

Jnz 

Inc 

advl;  ret 

• 

server 

advl 

server 

tlncrement  server  number  to  next 
rvalue 

r  server*server+l 

rSklp  reserved  value 

La. 

f  ^  '  “ 

■ 

request : 

rget  a  ticket  number  and  wait  to  be 

f  served 

push 

es 

mov 

ax,cmemseg 

rset  es  to  address  common 

mov 

es,az 

rmemory 

■ 

call 

ticket 

r^et  ticket  number 

call 

await 

iwalt  to  be  served 

•  . 

pop 

es 

ret 

•  MB  H  M 

release: 


>adv  server  number  on  completion 
fOf  read  or  write  operation 


push  es 

mov  ax,cmemseg 
mov  es»az 
call  advance 
pop  es 
ret 


;set  es  to  address  common 
Tmemory 

fine  server  number 


push  es 

mov  aztcnemseg 
mov  es«az 
mov  az»l 
nov  saric.er,az 
mov  nezt*az 
pop  es 
ret 

;  Data 

ase^  iouly  one  set  of  sequencer  variables 

iezist  In  common  memory;  accessed 
fvia  es 

server  rw  l 
next  rw  1 

cseg  $ 

tend  synch. a66 


;set  es  to  address  common 
tmemory 

;server»nezt®l 
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